[auto] adding content to master->master (#777)

github-automation-metabase · Metabase Docs bot · web-flow · commit b860c6be0219 · 2025-11-07T02:06:32.000+02:00
Co-authored-by: Metabase Docs bot &lt;metabase-bot@metabase.com&gt;
diff --git a/_docs/master/ai/metabot.md b/_docs/master/ai/metabot.md
@@ -53,6 +53,7 @@ Some tips:
 - Whenever you want Metabot to do something completely different, you should reset the conversation, as Metabot might find that irrelevant historical context to be confusing.
 - Once Metabot creates a question for you, you can follow up with more questions or take over yourself. You can drill through the chart or step into the editor to tweak the query (both in the query builder and the SQL editor).
 - Metabot works best with English prompts. While it might understand other languages, you'll get the most reliable results by asking your questions in English.
+- Define domain-specific terms in the [glossary](../exploration-and-organization/data-model-reference#glossary) to help Metabot understand your organization's terminology.
 
 ### Metabot response menu
 
diff --git a/_docs/master/ai/settings.md b/_docs/master/ai/settings.md
@@ -48,6 +48,7 @@ The best thing you can do to improve Metabot's performance is to prep your data
 - [Add models and metrics to your Metabot collection](#add-models-and-metrics-to-your-metabot-collection)
 - [Add descriptions for your data and content](#add-descriptions-for-your-data-and-content)
 - [Make sure the semantic types for each field are correct](#make-sure-the-semantic-types-for-each-field-are-correct)
+- [Define domain-specific terms in the glossary](#define-domain-specific-terms-in-the-glossary)
 - [Curate prompt suggestions](#curate-prompt-suggestions)
 
 ### Add models and metrics to your Metabot collection
@@ -76,6 +77,12 @@ Make sure the semantic types for each field accurately describe the field's "mea
 
 Metabase will try to set semantic types automatically, but you should confirm that each field has the relevant semantic type. See [Data types and semantic types](../data-modeling/semantic-types). You can also set semantic types for [models](../data-modeling/models#add-metadata-to-columns-in-a-model).
 
+### Define domain-specific terms in the glossary
+
+Add your organization's terminology, acronyms, and business-specific terms to the [glossary](../exploration-and-organization/data-model-reference#glossary). When Metabot receives a prompt, it can look up terms in the glossary to better 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?" This is especially helpful for industry-specific jargon, internal product names, or abbreviations unique to your organization.
+
 ### Curate prompt suggestions
 
 When you select a collection for Metabot to "learn", Metabot will suggest a series of prompts based on the content it finds in that collection. These prompts just give people a feel for the kinds of things people can ask Metabot to do.
diff --git a/_docs/master/data-modeling/models.md b/_docs/master/data-modeling/models.md
@@ -126,7 +126,7 @@ There are some limitations to this indexing:
 
 You can edit a model's query by clicking on the down arrow next to the model's name and clicking on **Edit query definition**. When you're doing editing, be sure to save your changes. Unlike questions, which prompt you to save as a new question, any changes here will overwrite the existing model. If you want to create a new model from an existing model, select **Duplicate this model** from the model sidebar (the icon of two overlapping squares).
 
-### Checking for for breaking changes
+### Checking for breaking changes
 
 > {% include plans-blockquote.html feature="Checking for breaking changes" %}
 
diff --git a/_docs/master/exploration-and-organization/data-model-reference.md b/_docs/master/exploration-and-organization/data-model-reference.md
@@ -56,9 +56,9 @@ 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. Currently, the glossary is a simple key-value store of terms and their definitions.
+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.
 
-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). 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?"
 
 ## Segments
 
diff --git a/_docs/master/questions/introduction.md b/_docs/master/questions/introduction.md
@@ -61,7 +61,7 @@ Questions that live in a dashboard are only visible in that dashboard. These que
 
 Questions saved to a collection can be added to multiple dashboards. Moving a question from one collection to another collection won't have any effect on the dashboards the question has been added to. To save a question to a collection, you'll need to be in a group with [curate access](../permissions/collections#curate-access) to that collection.
 
-### Checking for for breaking changes
+### Checking for breaking changes
 
 > {% include plans-blockquote.html feature="Checking for breaking changes" %}
 
diff --git a/_site/docs/master/ai/metabot.html b/_site/docs/master/ai/metabot.html
@@ -4959,6 +4959,7 @@ <h2 id="the-metabot-chat-sidebar">The Metabot chat sidebar</h2>
   <li>Whenever you want Metabot to do something completely different, you should reset the conversation, as Metabot might find that irrelevant historical context to be confusing.</li>
   <li>Once Metabot creates a question for you, you can follow up with more questions or take over yourself. You can drill through the chart or step into the editor to tweak the query (both in the query builder and the SQL editor).</li>
   <li>Metabot works best with English prompts. While it might understand other languages, you’ll get the most reliable results by asking your questions in English.</li>
+  <li>Define domain-specific terms in the <a href="../exploration-and-organization/data-model-reference#glossary">glossary</a> to help Metabot understand your organization’s terminology.</li>
 </ul>
 
 <h3 id="metabot-response-menu">Metabot response menu</h3>
diff --git a/_site/docs/master/ai/settings.html b/_site/docs/master/ai/settings.html
@@ -4952,6 +4952,7 @@ <h2 id="tips-for-making-the-most-of-metabot">Tips for making the most of Metabot
   <li><a href="#add-models-and-metrics-to-your-metabot-collection">Add models and metrics to your Metabot collection</a></li>
   <li><a href="#add-descriptions-for-your-data-and-content">Add descriptions for your data and content</a></li>
   <li><a href="#make-sure-the-semantic-types-for-each-field-are-correct">Make sure the semantic types for each field are correct</a></li>
+  <li><a href="#define-domain-specific-terms-in-the-glossary">Define domain-specific terms in the glossary</a></li>
   <li><a href="#curate-prompt-suggestions">Curate prompt suggestions</a></li>
 </ul>
 
@@ -4980,6 +4981,12 @@ <h3 id="make-sure-the-semantic-types-for-each-field-are-correct">Make sure the s
 
 <p>Metabase will try to set semantic types automatically, but you should confirm that each field has the relevant semantic type. See <a href="../data-modeling/semantic-types">Data types and semantic types</a>. You can also set semantic types for <a href="../data-modeling/models#add-metadata-to-columns-in-a-model">models</a>.</p>
 
+<h3 id="define-domain-specific-terms-in-the-glossary">Define domain-specific terms in the glossary</h3>
+
+<p>Add your organization’s terminology, acronyms, and business-specific terms to the <a href="../exploration-and-organization/data-model-reference#glossary">glossary</a>. When Metabot receives a prompt, it can look up terms in the glossary to better understand your request.</p>
+
+<p>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?” This is especially helpful for industry-specific jargon, internal product names, or abbreviations unique to your organization.</p>
+
 <h3 id="curate-prompt-suggestions">Curate prompt suggestions</h3>
 
 <p>When you select a collection for Metabot to “learn”, Metabot will suggest a series of prompts based on the content it finds in that collection. These prompts just give people a feel for the kinds of things people can ask Metabot to do.</p>
diff --git a/_site/docs/master/data-modeling/models.html b/_site/docs/master/data-modeling/models.html
@@ -5037,7 +5037,7 @@ <h2 id="edit-a-models-query">Edit a model’s query</h2>
 
 <p>You can edit a model’s query by clicking on the down arrow next to the model’s name and clicking on <strong>Edit query definition</strong>. When you’re doing editing, be sure to save your changes. Unlike questions, which prompt you to save as a new question, any changes here will overwrite the existing model. If you want to create a new model from an existing model, select <strong>Duplicate this model</strong> from the model sidebar (the icon of two overlapping squares).</p>
 
-<h3 id="checking-for-for-breaking-changes">Checking for for breaking changes</h3>
+<h3 id="checking-for-breaking-changes">Checking for breaking changes</h3>
 
 <blockquote>
 
diff --git a/_site/docs/master/exploration-and-organization/data-model-reference.html b/_site/docs/master/exploration-and-organization/data-model-reference.html
@@ -4955,9 +4955,9 @@ <h3 id="database-details">Database details</h3>
 
 <h2 id="glossary">Glossary</h2>
 
-<p>The glossary is a place where anyone can define terms relevant to your data. Currently, the glossary is a simple key-value store of terms and their definitions.</p>
+<p>The glossary is a place where anyone can define terms relevant to your data. To add a new term, click <strong>+ New term</strong>. Add the term name and its definitions, then click the checkmark to save the term to the glossary.</p>
 
-<p>To add a new term, click <strong>+ New term</strong>. Add the term name and its definitions, then click the checkmark to save the term to the glossary.</p>
+<p>The glossary is particularly useful for <a href="../ai/metabot">Metabot</a>. 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?”</p>
 
 <h2 id="segments">Segments</h2>
 
diff --git a/_site/docs/master/questions/introduction.html b/_site/docs/master/questions/introduction.html
@@ -4955,7 +4955,7 @@ <h3 id="saving-questions-to-collections">Saving questions to collections</h3>
 
 <p>Questions saved to a collection can be added to multiple dashboards. Moving a question from one collection to another collection won’t have any effect on the dashboards the question has been added to. To save a question to a collection, you’ll need to be in a group with <a href="../permissions/collections#curate-access">curate access</a> to that collection.</p>
 
-<h3 id="checking-for-for-breaking-changes">Checking for for breaking changes</h3>
+<h3 id="checking-for-breaking-changes">Checking for breaking changes</h3>
 
 <blockquote>
 
