> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-style-guide-models-runs-20260604-113608.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add labels to runs with tags

> Add, update, and remove tags on W&B runs using the Python SDK, Public API, or the W&B App UI for organization.

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.

<Tabs>
  <Tab title="W&B Python SDK">
    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:

    ```python theme={null}
    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:

    ```python theme={null}
    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]",)
    ```
  </Tab>

  <Tab title="Public API">
    Use the [W\&B Public API](/models/ref/python/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:

    ```python theme={null}
    run = wandb.Api().run("{entity}/{project}/{run-id}")
    run.tags.append("tag1")  # you can choose tags based on run data here
    run.update()
    ```
  </Tab>

  <Tab title="Project page">
    This method is best suited to tagging many runs with the same tags.

    1. Navigate to your project workspace.
    2. Select **Runs** from the project sidebar.
    3. Select one or more runs from the table.
    4. After 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.
  </Tab>

  <Tab title="Run page">
    This method is best suited to manually applying tags to a single run.

    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 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.
  </Tab>
</Tabs>

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.

<Tabs>
  <Tab title="Project page">
    This method is best suited to removing tags from many runs.

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

  <Tab title="Run page">
    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.
  </Tab>
</Tabs>

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