Add labels to runs with tags

This page describes how to add, update, and remove tags on W&B runs so you can organize and identify runs by characteristics that logged metrics or artifact data don’t capture. Add tags to label runs with particular features that might not be apparent from the logged metrics or artifact data. For example, you can add a tag to a run to indicate that the run’s model is in_production, that the run is preemptible, or that the run represents the baseline.

Add tags to one or more runs

You can add tags to runs programmatically with the W&B Python SDK or Public API, or interactively from the W&B App UI. Select the tab that best fits your use case.

W&B Python SDK
Public API
Project page
Run page

Use wandb.init() to add tags when you initialize a run. Pass a list of strings to the tags parameter in wandb.init() to add tags to a run. For example:

import wandb

with wandb.init(
  entity="[ENTITY]",
  project="[PROJECT]",
  tags=["[TAG1]", "[TAG2]"]
) as run:
    # Your training code here.

You can also add or update an existing tag during an active run by updating the tags attribute of the run object (wandb.Run.tags). The tags attribute accepts a tuple of strings. Concatenate one or more tags to the existing run tag property to add new tags after you initialize the run:

import wandb

with wandb.init(entity="[ENTITY]", project="[PROJECT]", tags=["[TAG1]"]) as run:
  # Training loop logic here.

  # Add a new tag to the run object.
  run.tags += ("[NEW_TAG]",)

Use the W&B Public API to add or update tags on a previously saved run.To update tags on an existing run, access the wandb.Run.tags property. The wandb.Run.tags property consists of a list of strings. Concatenate the new tag or tags to the existing tags and then call wandb.Run.update() to update the run with the new tags. For example:

run = wandb.Api().run("{entity}/{project}/{run-id}")
run.tags.append("tag1")  # you can choose tags based on run data here
run.update()

After you complete the steps in the tab you selected, the specified tags appear on the runs you targeted.

Remove tags from one or more runs

Follow these steps to remove tags from a run in the W&B App. Select the tab that matches whether you want to remove tags from many runs at once or from a single run.

Project page
Run page

This method is best suited to removing tags from many runs.

In the run sidebar of the project, select the table icon in the upper right. This expands the sidebar into the full runs table.
Hover over a run in the table to see a checkbox, or use the checkbox in the header row to select all runs.
Select the checkbox to enable bulk actions.
Select the runs you want to remove tags from.
Select the Tag button above the rows of runs.
Select the checkbox next to a tag to remove it from the run.

After you complete the steps in the tab you selected, the specified tags no longer appear on the runs you targeted.

Guides

Integrations

Reference

Add tags to one or more runs

Remove tags from one or more runs

​Add tags to one or more runs

​Remove tags from one or more runs

Add tags to one or more runs

Remove tags from one or more runs