add clearer explanation of labels

Signed-off-by: nikki everett <[email protected]>
dagster-io · Mar 3, 2025 · e945519 · e945519
1 parent 88bff92
commit e945519
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 0 deletions.
diff --git a/docs/docs/guides/build/assets/metadata-and-tags/tags.md b/docs/docs/guides/build/assets/metadata-and-tags/tags.md
@@ -34,6 +34,22 @@ Tag values must:
 - Contain only alphanumeric characters, dashes (`-`), underscores (`_`), and dots (`.`)
 - Be a string or JSON that is serializable to a string
 
+### Labels
+
+A label is a tag that only contains a key. To create a label, set the tag value to an empty string:
+
+```python
+@dg.asset(
+    tags={"private":""}
+)
+def my_asset() -> None:
+    ...
+```
+
+A label will look like the following in the UI:
+
+![Label in UI](/images/guides/build/assets/metadata-tags/label-ui.png)
+
 ### Customizing run execution with tags
 
 While tags are primarily used for labeling and organization, some run execution features are controlled using run tags:

diff --git a/docs/static/images/guides/build/assets/metadata-tags/label-ui.png b/docs/static/images/guides/build/assets/metadata-tags/label-ui.png