Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs: add glossary article (#82308)

Alex Yaroshefb95e2e1865
diff --git a/docs/data-modeling/semantic-layer/glossary.md b/docs/data-modeling/semantic-layer/glossary.md
new file mode 100644
index 00000000000..fb7988b5250
--- /dev/null
+++ b/docs/data-modeling/semantic-layer/glossary.md
@@ -0,0 +1,45 @@
+---
+title: Glossary
+summary: Define terms to help your team and Metabot understand your data.
+---
+
+# Glossary
+
+The glossary is a place where anyone can define terms relevant to your data.
+
+## Use the glossary to give Metabot context
+
+The glossary is particularly useful for [Metabot](../../ai/metabot.md). When Metabot gets a prompt, it can look up glossary terms to understand your request. For example, if you define "MRR" as "Monthly Recurring Revenue" in your glossary, Metabot will know what you mean when you ask "What's our MRR for Q4?"
+
+![Metabot using the glossary](images/glossary.png)
+
+## Manage the glossary
+
+You can manage the glossary in [Data Studio](../data-studio.md). You need to be an admin or in the Data Analyst group to access Data Studio.
+
+1. Click on the **grid** icon in the top right and select **Data Studio**.
+2. In the left sidebar, click on **Glossary**.
+3. To add a new term, click **+ New term**. Add the term name and its definitions, then click the checkmark to save the term to the glossary.
+
+ To remove a glossary term, hover over it and click on the **X** icon.
+
+ To edit a glossary term or definition, click on the term or definition.
+
+
+Metabot will start using glossary terms automatically.
+
+## Glossary outside Data Studio
+
+In addition to Data Studio, everyone in your Metabase can browse and add terms to the glossary if they have access to [Data Reference](../../exploration-and-organization/data-model-reference.md).
+
+To see the glossary in Data Reference:
+1. If the left navigation sidebar is hidden, open it by clicking on the **three lines** icon in top left.
+2. In the left navigation sidebar, click **Databases**.
+3. Click "Learn about our data" above the list of databases. This will open [Data Reference](../../exploration-and-organization/data-model-reference.md).
+4. In Data Reference, click **Glossary** in the left sidebar.
+
+ ![Glossary in data reference](images/glossary-in-data-reference.png)
+
+
+
+
diff --git a/docs/data-modeling/semantic-layer/images/glossary-in-data-reference.png b/docs/data-modeling/semantic-layer/images/glossary-in-data-reference.png
new file mode 100644
index 00000000000..a9c4f0a28d2
Binary files /dev/null and b/docs/data-modeling/semantic-layer/images/glossary-in-data-reference.png differ
diff --git a/docs/data-modeling/semantic-layer/images/glossary.png b/docs/data-modeling/semantic-layer/images/glossary.png
new file mode 100644
index 00000000000..f91e42abf49
Binary files /dev/null and b/docs/data-modeling/semantic-layer/images/glossary.png differ
diff --git a/docs/exploration-and-organization/data-model-reference.md b/docs/exploration-and-organization/data-model-reference.md
index 49fd86039b6..47f0ead57b2 100644
--- a/docs/exploration-and-organization/data-model-reference.md
+++ b/docs/exploration-and-organization/data-model-reference.md
@@ -51,9 +51,7 @@ Admins can edit the metadata in this reference by clicking the **Edit** button i
## Glossary
-The glossary is a place where anyone can define terms relevant to your data. To add a new term, click **+ New term**. Add the term name and its definitions, then click the checkmark to save the term to the glossary.
-
-The glossary is particularly useful for [Metabot](../ai/metabot.md). When Metabot gets a prompt, it can look up glossary terms to understand your request. For example, if you define "MRR" as "Monthly Recurring Revenue" in your glossary, Metabot will know what you mean when you ask "What's our MRR for Q4?"
+See [Glossary](../data-modeling/semantic-layer/glossary.md)
## Segments
diff --git a/docs/util/data/nav.yml b/docs/util/data/nav.yml
index 2d8c295aa94..b09e1ecc644 100644
--- a/docs/util/data/nav.yml
+++ b/docs/util/data/nav.yml
@@ -217,6 +217,8 @@ categories:
url: "data-modeling/semantic-layer/measures"
- name: "Segments"
url: "data-modeling/semantic-layer/segments"
+ - name: "Glossary"
+ url: "data-modeling/semantic-layer/glossary"
- name: "Tools"
pages:
- name: "Schema viewer"