Organize versions with tags

Use tags to organize collections or artifact versions within collections. You can add, remove, edit tags with the Python SDK or W&B App UI.

Create and add tags to organize your collections or artifact versions within your registry. Add, modify, view, or remove tags to a collection or artifact version with the W&B App UI or the W&B Python SDK.

When to use a tag versus using an alias

Use aliases when you need to reference a specific artifact version uniquely. For example, use an alias such as ‘production’ or ‘latest’ to ensure that artifact_name:alias always points to a single, specific version.

Use tags when you want more flexibility for grouping or searching. Tags are ideal when multiple versions or collections can share the same label, and you don’t need the guarantee that only one version is associated with a specific identifier.

Add a tag to a collection

Use the W&B App UI or Python SDK to add a tag to a collection:

W&B App

Use the W&B App UI to add a tag to a collection:

1. Navigate to the W&B Registry App.
2. Click on a registry card
3. Click View details next to the name of a collection
4. Within the collection card, click on the plus icon (+) next to the Tags field and type in the name of the tag
5. Press Enter on your keyboard

Update tags that belong to a collection

Update a tag programmatically by reassigning or by mutating the tags attribute. W&B recommends, and it is good Python practice, that you reassign the tags attribute instead of in-place mutation.

For example, the proceeding code snippet shows common ways to update a list with reassignment. For brevity, we continue the code example from the Add a tag to a collection section:

collection.tags = [*collection.tags, "new-tag", "other-tag"]
collection.tags = collection.tags + ["new-tag", "other-tag"]

collection.tags = set(collection.tags) - set(tags_to_delete)
collection.tags = []  # deletes all tags

The following code snippet shows how you can use in-place mutation to update tags that belong to an artifact version:

collection.tags += ["new-tag", "other-tag"]
collection.tags.append("new-tag")

collection.tags.extend(["new-tag", "other-tag"])
collection.tags[:] = ["new-tag", "other-tag"]
collection.tags.remove("existing-tag")
collection.tags.pop()
collection.tags.clear()

View tags that belong to a collection

Use the W&B App UI to view tags added to a collection:

1. Navigate to the W&B Registry App.
2. Click on a registry card
3. Click View details next to the name of a collection

If a collection has one or more tags, you can view those tags within the collection card next to the Tags field.

Tags added to a collection also appear next to the name of that collection.

For example, in the proceeding image, a tag called “tag1” was added to the “zoo-dataset-tensors” collection.

Remove a tag from a collection

Use the W&B App UI to remove a tag from a collection:

1. Navigate to the W&B Registry App.
2. Click on a registry card
3. Click View details next to the name of a collection
4. Within the collection card, hover your mouse over the name of the tag you want to remove
5. Click on the cancel button (X icon)

Add a tag to an artifact version

Add a tag to an artifact version linked to a collection with the W&B App UI or with the Python SDK.

W&B App

1. Navigate to the W&B Registry at https://wandb.ai/registry
2. Click on a registry card
3. Click View details next to the name of the collection you want to add a tag to
4. Scroll down to Versions
5. Click View next to an artifact version
6. Within the Version tab, click on the plus icon (+) next to the Tags field and type in the name of the tag
7. Press Enter on your keyboard

Update tags that belong to an artifact version

Update a tag programmatically by reassigning or by mutating the tags attribute. W&B recommends, and it is good Python practice, that you reassign the tags attribute instead of in-place mutation.

For example, the proceeding code snippet shows common ways to update a list with reassignment. For brevity, we continue the code example from the Add a tag to an artifact version section:

artifact.tags = [*artifact.tags, "new-tag", "other-tag"]
artifact.tags = artifact.tags + ["new-tag", "other-tag"]

artifact.tags = set(artifact.tags) - set(tags_to_delete)
artifact.tags = []  # deletes all tags

The following code snippet shows how you can use in-place mutation to update tags that belong to an artifact version:

artifact.tags += ["new-tag", "other-tag"]
artifact.tags.append("new-tag")

artifact.tags.extend(["new-tag", "other-tag"])
artifact.tags[:] = ["new-tag", "other-tag"]
artifact.tags.remove("existing-tag")
artifact.tags.pop()
artifact.tags.clear()

View tags that belong to an artifact version

View tags that belong to an artifact version that is linked to a registry with the W&B App UI or with the Python SDK.

W&B App

1. Navigate to the W&B Registry App.
2. Click on a registry card
3. Click View details next to the name of the collection you want to add a tag to
4. Scroll down to Versions section

If an artifact version has one or more tags, you can view those tags within the Tags column.

Remove a tag from an artifact version

1. Navigate to the W&B Registry App.
2. Click on a registry card
3. Click View details next to the name of the collection you want to add a tag to
4. Scroll down to Versions
5. Click View next to an artifact version
6. Within the Version tab, hover your mouse over the name of the tag
7. Click on the cancel button (X icon)

Search existing tags

Use the W&B App UI to search existing tags in collections and artifact versions:

1. Navigate to the W&B Registry App.
2. Click on a registry card
3. Within the search bar, type in the name of a tag.

Find artifact versions with a specific tag

Use the W&B Python SDK to find artifact versions that have a set of tags:

import wandb

api = wandb.Api()
tagged_artifact_versions = api.artifacts(
    type_name = "<artifact_type>",
    name = "<artifact_name>",
    tags = ["<tag_1>", "<tag_2>"]
)

for artifact_version in tagged_artifact_versions:
    print(artifact_version.tags)