This page explains the "Subcategory" setting available when uploading files.
Table of Contents
2. Why subcategories are needed (file upload specifications)
3. With vs. without subcategories (example)
4. Upload boxes that support subcategories
6. Notes
1. What is a subcategory?
A subcategory is a feature that lets you split the files you upload to the same upload box into separate groups (subcategories).
You can name subcategories freely (e.g. "Wallet A", "Exchange B", "Account 1"). Because transaction history is managed separately for each subcategory, you can upload multiple files whose periods overlap, without worrying about the upload order.
Use subcategories in cases such as:
- You create separate custom files (or Gtax Common Format files) for each exchange, wallet, or counterparty
- You trade with multiple accounts on an exchange that supports subcategories, such as Hyperliquid
If you only have one file, or you keep adding new transactions to the same file, you do not need to set a subcategory.
2. Why subcategories are needed (file upload specifications)
To prevent the same transaction from being recorded twice, cryptact only imports transactions that occur after the "Latest transaction timestamp" already imported into the same upload box.
You can check the "Latest transaction timestamp" at the bottom right of each upload box.
(Example image: bitFlyer / Trade History)
Therefore, when uploading multiple files to the same upload box, you need to upload them in order, starting from the file with the oldest transactions.
Example: Uploading the following three files to "bitFlyer / Trade History"
- A: January 1, 2024 – December 31, 2024
- B: October 1, 2024 – April 30, 2025
- C: January 1, 2025 – December 31, 2025
⭕ If you upload in the order A → B → C
All transactions from January 1, 2024 to December 31, 2025 are imported correctly. Overlapping periods (e.g. October–December 2024 in file B, which is also in file A) are skipped automatically, so no transaction is recorded twice.
❌ If you upload C first
The Latest transaction timestamp becomes December 31, 2025, so transactions in files A and B, which are earlier than that date, will not be imported.
In this case, delete all transactions uploaded from file C on the Transaction Page, and then re-upload the files in the order A → B → C.
Related pages:
How to Upload a Exchange Files Correctly
How to resolve the "No new transactions found in the uploaded file. This could be because the transactions are either already uploaded or from a locked date" error during file upload
For exchange files, uploading them in chronological order is enough. However, if you split custom files by exchange or wallet, their periods overlap, and because of this specification, some transactions may not be imported. Subcategories solve this problem.
3. With vs. without subcategories (example)
Suppose you have recorded 2025 transactions for two wallets in two separate custom files:
- File X: Wallet A transactions (January 1, 2025 – December 31, 2025)
- File Y: Wallet B transactions (January 1, 2025 – December 31, 2025)
▼ Without subcategories
Files X and Y are treated by the system as a single transaction history.
If you upload X first, the Latest transaction timestamp becomes December 31, 2025, so when you upload Y afterward, almost none of Y's transactions are imported (only transactions after X's Latest transaction timestamp are imported).
▼ With subcategories
| Subcategory name | File to upload |
|---|---|
| Wallet A | File X |
| Wallet B | File Y |
The Latest transaction timestamp is managed separately for each subcategory, so both X and Y are imported correctly even though their periods overlap. The order in which you upload X and Y does not matter.
* Within the same subcategory, please continue to upload files in order, starting from the oldest.
For example, to add Wallet A's 2026 transactions, select the subcategory "Wallet A" and upload the 2026 file.
4. Upload boxes that support subcategories
Subcategories are mainly available in the following upload boxes. You can also use them in any other upload box that shows a "Subcategory" field on the upload screen.
| Upload box | Typical use |
|---|---|
| Custom | Manage separate files for each exchange, wallet, or counterparty |
| Gtax Common Format | Manage separate files for each exchange, wallet, or counterparty |
| Some exchanges, such as Hyperliquid | Manage separate files for each account |
For Gtax Common Format users
If you created separate Common Format files for each exchange or wallet in Gtax, upload each type of file under its own subcategory.
On the other hand, if your files do not overlap in period (e.g. one file per month), you can upload them under the same subcategory, starting from the oldest month.
5. How to set a subcategory
The steps below use a custom file as an example.
For the Gtax Common Format, select "Gtax" from the exchange list in step 2, then select or create a subcategory in the "Subcategory" field of the Common Format upload box. The rest of the steps are the same.
1. Click the "+" icon in the top right-hand corner of the screen and then click "Upload files".
2. Select "Custom" in the top left.
3. In the "Subcategory" field, enter a subcategory name (up to 32 characters) and click "Add". In the image below, a new subcategory "staking" is added. To add files to an existing subcategory, select the same subcategory name.
4. Drag & drop the file and click "Upload".
(Example image: Custom file upload screen)
You can also delete transaction history per subcategory.
6. Notes
-
When uploading the second time or later, select the same subcategory name as before.
If you upload the same file under a different subcategory name, it will be treated as a separate file, and transactions may be recorded twice. -
Subcategory names cannot be changed later.
To change a name, delete all transactions in that subcategory on the Transaction Page, then re-upload the files with the new subcategory name. - There is no limit to the number of subcategories you can create.
7. If you have multiple accounts on Hyperliquid
Subcategories are also available in the Hyperliquid upload box. By setting a subcategory name for each account before uploading files, transaction history is reflected in chronological order for each account.
* There may be restrictions on the history that can be obtained from Hyperliquid files. Before deleting history in order to re-upload, please make sure you can obtain the necessary files.
For detailed instructions, see the following help pages:
I have multiple accounts on Hyperliquid. How can I upload files for multiple accounts?
How to get trade history from Hyperliquid