Acceldata
AIO

Last updated: Nov 17, 2026 16:55 UTC

Add key:value tags to a trace, a session, or a span after it's recorded, and remove them when you no longer need them.

Manual tags are useful for labels you decide on while reviewing data, for example reviewer:qa or status:needs-review. To set tags from your application instead, see Tag traces in code.

Prerequisites

  • You need permission to modify the project. With view permission only, you can see tags but not add or remove them: Add tag and the ✕ buttons don't show, and an item with no tags shows No tags. For details, see Project permissions.
  • The trace needs at least one span, or the session at least one turn. Until then, the tag row doesn't show.

Where manual tags go

Each tag belongs to the item you add it to. A tag you add to a span doesn't show on its trace or session, and a tag you add to a trace or session doesn't show on its spans.

To tag Go to The tags show
A trace The trace page Above the trace's stat strip
A session The session page Above the session's stat strip
A span The trace page or the session page, then select a span In the span pane, below the tabs and above the span's details

To find a trace or session, see Explore traces.

Add a tag

  1. Open the trace, session, or span you want to tag, and in its tag row, select Add tag.

The trace page, with the trace's tag row and its Add tag button above the stat strip

The Add tag dialog opens with one row, which has a Key name column and a Value column.
2. For Key name, choose Select a key. Enter text in Search keys, then choose a key the project already uses. To use a new key, enter it and choose Add “reviewer”, where reviewer is the text you entered.

If the project has no tags yet, the list shows No tags in this project yet.
3. For Value, choose Select values. Enter text in Search values, then select one or more existing values. To use a new value, enter it and choose Add “qa”, where qa is the text you entered.

Value is available only after you choose a key. To remove a value you chose, select the ✕ next to it.
4. To tag with another key, select Add row and repeat steps 2 and 3. To delete a row, select its remove control.
5. Select the confirm button. It reads Add tag for one key and value, or Add 3 tags when you've chosen three. Until you choose a key and value, it reads Add.

When every tag saves, the dialog closes and the tag row reloads with your new tags.

Rules for keys and values

  • A key can't be blank, and it can't contain a colon (:).
  • A value can't be blank, and it can be up to 200 characters long. A value can contain a colon.
  • Spaces at the start and end of a key or value are removed before the tag is saved.
  • A key can have more than one value, for example reviewer:nitish and reviewer:qa. Each value is its own tag.
  • The dialog doesn't offer a key you've already chosen on another row, or a value the item already has.

Remove a tag

  • In the tag row, select the ✕ next to the value you want to remove.

The tag row reloads. Only manual tags have a ✕. Tags set in code or made from span attributes can't be removed in the UI. To learn where each kind of tag comes from, see Tags overview.

How long manual tags are kept

A manual tag is kept for 90 days after the earliest span of the tagged item started. For how long traces themselves are kept, see Data retention.

Troubleshooting

"Add a key and at least one value."

You selected the confirm button before choosing anything. Choose a key and at least one value, then try again.

"Each row needs a key and at least one value."

One row has a key without a value, or values without a key. Complete the row, or delete it.

Some tags didn't save

The dialog saves each key and value one at a time. If one fails, the tags that saved are taken out of the dialog, and only the unsaved ones stay, with an error. Check the error, fix the remaining rows, and confirm again. Only the unsaved tags are sent.

If removing a tag fails, the error shows under the tag row.

Next steps