Skip to main content
All CollectionsTransactions / Tags
What are Tags
What are Tags

Modifying the behavior of transactions by applying tags

Jack avatar
Written by Jack
Updated over 2 months ago

You can apply a tag to your transactions in Koinly to modify the transaction's behavior or for better categorization. This article lists all tags available for deposits, withdrawals and trades.

ℹ️ Tags used to be labels

We no longer use the words "Tag" and "Label" interchangeably. They are "Tags"

⬇️ Tags for deposits

Without any tags, deposits are considered acquisitions of an asset (equivalent to "bought at market price").
​

Income tags

  • Static: Salary, Income, Lending interest

  • Adjustable: Airdrop, Fork, Mining, Reward,

  • The worth (market value) of deposits with those tags will increase your income

  • Behavior of adjustable tags can be modified via settings - see Treat rewards/airdrops/mining as income
    ​

Cashback tags

  • Static: Fee refund

  • Adjustable: Cashback

  • These tags do not change the behavior of the transaction (it remains an acquisition)

  • Behavior of transactions with Cashback tag can be modified in Settings
    ​

PNL tag

Loan tags

  • Loan, Margin loan

  • These tags do not change the behavior of the transaction (it remains an acquisition)

  • Loan tags help in filtering and viewing your transactions, providing additional context
    ​

Liquidity tag

  • Liquidity in

  • Liquidity tags are applied automatically to a multi-trade transaction involving an LP token

  • This tag cannot be applied manually

  • Behavior of transactions with liquidity tags can be modified in Settings
    ​

Pool tag

  • Deposits tagged with Remove from Pool will no longer be an acquisition but a transfer from the pool wallet

  • See Staking/farming tokens for more information on what the pool tag does

⬆️ Tags for withdrawals

Without any tags, withdrawals are considered disposals of assets (equivalent to "sold at market price").
​

Expense tags

  • Cost, Tax, Margin fee, Loan fee

  • "Send" transactions tagged with an expense tag remain a disposal but their worth (market value) will be summed up in the "Costs and Expenses" section of your tax report, in case you consider them deductible
    ​

Non-taxable tags

  • Gift, Lost, Donation

  • Withdrawals with this tag will not generate any gain or loss

  • Technically, this is still a disposal but Koinly automatically matches the worth (market value) with the cost basis, so the gain/loss is calculated as zero

  • Be sure that transactions like that are non-taxable in your country before applying any of those tags
    ​

PNL tag

  • Realized PNL

  • Withdrawals with this tag are still disposals (as if the asset was sold)

  • The worth (market value) of withdrawals with this tag is deducted from other gains

  • See Futures and perpetuals (PNL transactions) for more information
    ​

Loan tags

  • Loan repayment, Margin repayment

  • These tags do not change the behavior of the transaction (it remains a disposal)

  • Loan tags help in filtering and viewing your transactions, providing additional context
    ​

Liquidity tag

  • Liquidity out

  • Liquidity tags are applied automatically to a multi-trade transaction involving an LP token

  • This tag cannot be applied manually

  • Behavior of transactions with liquidity tags can be modified in Settings

Pool tag

  • Withdrawals tagged with Add to Pool will no longer be a disposal but a transfer to the pool wallet

  • See Staking/farming tokens for more information on what the pool tag does

🔄 Tags for trades

Without any tags, "Exchange" transactions are considered a disposal (sale) of one asset and an acquisition (purchase) of another asset happening at the same time.
​

Swap tag

  • Swap

  • "Exchange" transactions tagged as Swap will no longer generate gains/losses

  • The cost basis of the disposed asset is transferred directly to the acquired asset

  • For countries that observe short-/long-term gains, the date of acquisition is also transferred directly to the acquired asset

  • This tag is usually used for token migration and symbol changes - see Token rebases and symbol swaps
    ​

Liquidity tags

  • Liquidity in, Liquidity out

  • This tag is applied automatically when two or more assets are merged with an LP token

  • Liquidity tags cannot be applied on a trade transaction manually

  • Behavior of transactions with liquidity tags can be modified in Settings
    ​

☝️ Transactions that can't be tagged

Transaction types listed below cannot be tagged:

  • Transfers

  • Trades with fiat ("Buy" and "Sell" transactions)

How to apply tags

There are multiple ways to tag transactions in Koinly:

  1. From the transactions page

  2. From the edit popup

  3. Using multi-select

  4. Using bulk edit
    ​

Applying tags from the "Transactions" page

  1. When on the "Transactions" page, click the transaction type ("Withdrawal", "Deposit", "Exchange")

  2. Pick any of the available tags from the dropdown box

  3. You can also remove a previously added tag from here
    ​

Applying tags from the edit popup

☝️ Pool tags and the Swap tag are not available via the edit popup

  1. Click the 3-dot menu and select "Edit" or click the pencil icon next to the transaction

  2. At the bottom of the edit popup, click "+ Tag"

  3. Select one of the available tags

  4. You can also remove a previously added tag by clicking "×" next to its name

  5. Click "Save"
    ​

Applying tags using multi-select

  1. Select all the transactions you want to tag

  2. On the modal that shows at the bottom, click "Tags" and select the tag you want

  3. Only tags available for all transactions selected are shown

  4. The tags are applied the moment the tag is selected from the dropdown box

  5. You can also remove tags the same way
    ​

Applying tags using bulk edit

🎥 Showcase: How to apply tags in Koinly

See video below showcasing multiple ways to apply tags mentioned above:

Did this answer your question?