Add labels to runs with tags ↗
noOriginal Documentation
Documentation Index#
Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt Use this file to discover all available pages before exploring further.
Add tags to label runs with particular features that might not be obvious from the logged metrics or artifact data.
For example, you can add a tag to a run to indicated that run’s model is in_production, that run is preemptible, this run represents the baseline, and so forth.
Add tags to one or more runs#
Programmatically or interactively add tags to your runs.
Based on your use case, select the tab below that best fits your needs:
You can add tags to a run when it is created:
import wandb
with wandb.init(
entity="entity",
project="<project-name>",
tags=["tag1", "tag2"]
) as run:
# Your training code here
```
You can also update the tags after you initialize a run. For example, the following code snippet shows how to update a tag if a particular metrics crosses a pre-defined threshold:
```python
import wandb
with wandb.init(entity="entity", project="capsules", tags=["debug"]) as run:
# python logic to train model
if current_loss < threshold:
run.tags = run.tags + ("release_candidate",)
```
<span class="tab-end"></span>
<span class="tab-start" data-tab-title="Public API"></span>
After you create a run, you can update tags using [the Public API](/models/track/public-api-guide/). For example:
```python
with wandb.Api().run("{entity}/{project}/{run-id}") as run:
run.tags.append("tag1") # you can choose tags based on run data here
run.update()
```
<span class="tab-end"></span>
<span class="tab-start" data-tab-title="Project page"></span>
This method is best suited to tagging large numbers of runs with the same tag or tags.
1. Navigate to your project workspace.
2. Select **Runs** from the project sidebar.
3. Select one or more runs from the table.
4. Once you select one or more runs, select the **Tag** button above the table.
5. Type the tag you want to add and select the **Create new tag** checkbox to add the tag.
<span class="tab-end"></span>
<span class="tab-start" data-tab-title="Run page"></span>
This method is best suited to applying a tag or tags to a single run manually.
1. Navigate to your project workspace.
2. Click a run to open it. The run page opens with the **Overview** tab shown by default.
3. Select the gray plus icon (**+**) button next to **Tags**.
4. Type a tag you want to add and select **Add** below the text box to add a new tag.
<span class="tab-end"></span>
<span class="tab-group-end"></span>
## Remove tags from one or more runs
Follow these steps to remove tags from a run in the W\&B App.
<span class="tab-group-start"></span>
<span class="tab-start" data-tab-title="Project page"></span>
This method is best suited to removing tags from a large numbers of runs.
1. In the Run sidebar of the project, select the table icon in the upper-right. This will expand the sidebar into the full runs table.
2. Hover over a run in the table to see a checkbox on the left or look in the header row for a checkbox to select all runs.
3. Select the checkbox to enable bulk actions.
4. Select the runs you want to remove tags.
5. Select the **Tag** button above the rows of runs.
6. Select the checkbox next to a tag to remove it from the run.
<span class="tab-end"></span>
<span class="tab-start" data-tab-title="Run page"></span>
1. In the left sidebar of the Run page, select the top **Overview** tab. The tags on the run are visible here.
2. Hover over a tag and select the "x" to remove it from the run.
<span class="tab-end"></span>
<span class="tab-group-end"></span>Link last verified
June 7, 2026.
View original ↗
Source: Weights & Biases Docs
Link last verified: 2026-03-04