Use aliases as pointers to specific versions. By default, wandb.Run.log_artifact() adds the latest alias to the logged version.
Weights & Biases creates an artifact version v0 and attaches it to your artifact when you log that artifact for the first time. Weights & Biases checksums the contents when you log again to the same artifact. If the artifact changed, Weights & Biases saves a new version v1.
For example, if you want your training script to pull the most recent version of a dataset, specify latest when you use that artifact. The following code example demonstrates how to download a recent dataset artifact named bike-dataset that has an alias, latest:
You can also apply a custom alias to an artifact version. For example, if you want to mark that model checkpoint is the best on the metric AP-50, you could add the string 'best-ap50' as an alias when you log the model artifact. For the lengths and characters that aliases accept, see Alias limits.
Alias limits
An alias can be 1 to 128 characters long and can contain any character except / and :. Weights & Biases also applies the following rules:
- Weights & Biases manages the
latest alias and the version aliases for you, such as v0 and v1. If you add an alias that is v followed by a number, such as v3, Weights & Biases ignores it instead of returning an error (the W&B App shows a message instead).
- Aliases are case-sensitive, but a collection can’t have two aliases that differ only in letter case, accents, full-width versus half-width characters, or hiragana versus katakana. For example, if a collection has a
prod alias, adding Prod to any version returns an error.
Last modified on November 18, 2026