Tag filter dropdown missing tags from logged data

Applies to:

Plan -
Deployment -

Summary

Issue: Tags logged via the SDK do not appear in the tag filter dropdown in the experiments table, even though the tag values exist in logged span data. Cause: The filter dropdown shows explicitly registered project tags and tags inferred from recent logged data. Tags that are very new or appear rarely in logged data may not yet appear in the dropdown. Resolution: For tags that don’t appear yet, register them using the UI or POST /v1/project_tag, or filter using the SQL filter as an immediate workaround.

Resolution steps

To filter by an unregistered tag immediately

Use the SQL filter

In the experiments table, open the SQL filter and use this syntax:

tags includes ["<your tag name>"]

This works for any tag value regardless of whether it is registered as a project tag.

Register the tag via the UI

Navigate to your project settings
Go to the Tags section
Click “Add Tag”
Enter the tag name and optional description/color
Save the tag

Register the tag via the API (for bulk operations)

Send a POST /v1/project_tag request for each tag you want to appear in the dropdown:

curl -X POST https://api.braintrust.dev/v1/project_tag \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "<project_id>",
    "name": "<tag_name>",
    "color": "#000000"
  }'

Repeat across projects if needed

For multiple projects, use the UI for each project or script the API request above. Use GET /v1/project_tag to list existing tags before creating duplicates.

Notes

Tags that appear in recent logged data are surfaced automatically in the dropdown alongside configured project tags. Very new or rarely-used tags may have a delay before appearing.
Registering a project tag lets you set a color, description, and display order. It does not change or backfill existing logged data.
See the Project Tags API reference for full field options including description and color.

⌘I

​Summary

​Resolution steps

​To filter by an unregistered tag immediately

​Use the SQL filter

​To make tags appear in the filter dropdown

​Register the tag via the UI

​Register the tag via the API (for bulk operations)

​Repeat across projects if needed

​Notes

Summary

Resolution steps

To filter by an unregistered tag immediately

Use the SQL filter

To make tags appear in the filter dropdown

Register the tag via the UI

Register the tag via the API (for bulk operations)

Repeat across projects if needed

Notes