Skip to content

Add tags#

Tags make it easier to identify and organize your runs and models. You can add tags either at creation, or later via the API or web app.

(Runs) Adding tags at initialization#

Pass a list of tags to the tags argument at initialization:

import neptune

run = neptune.init_run(tags=["maskRCNN", "finetune", "prod_v2.0.1"])

Adding tags later#

Tags are stored in the sys/tags field, which is of the type StringSet. Use the add() method to add entries:

run["sys/tags"].add(["maskRCNN", "prod_v2.0.1"])
run["sys/tags"].add("finetune") # (1)!
  1. Adds finetune to the list of tags.
Adding tags to a model version
model_version = neptune.init_model_version(model="NLI-PRETRAINED")
model_version["sys/tags"].add(["finetune", "prod_v2.0.3"])


You can also include emoji in tags:

run["sys/tags"].add("best 🏆")

Managing tags in the web app#

In the table view, click inside the Tags column to edit the tags.

To edit tags in bulk, select multiple runs or models and click Manage tags in the upper right.


When fetching the experiments table, you can filter the results by tag. You can also fetch the tags of a run or other object as a list.

For details, see Query metadata from Neptune.