Skip to content

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

docs: the great detypoing (#72100)

Alex Yarosh9b768293047d
diff --git a/docs/actions/basic.md b/docs/actions/basic.md
index 763e3026210..608ac8654cb 100644
--- a/docs/actions/basic.md
+++ b/docs/actions/basic.md
@@ -4,7 +4,7 @@ title: Basic actions
# Basic actions
-Basic actions are "implicit" [actions](./introduction.md) that do things that people typically want to do when interacting with a database: Create, Update, Delete. Basic actions auto-track the schema of the source table backing the model. By auto-track the schema, we mean that Metabase will create action forms for people to fill out that include all of the fields from the primary source table that underlies that model.
+Basic actions are "implicit" [actions](./introduction.md) that do things that people typically want to do when interacting with a database: Create, Update, Delete. Basic actions auto-track the schema of the source table backing the model. By auto-tracking the schema, we mean that Metabase will create action forms for people to fill out that include all of the fields from the primary source table that underlies that model.
If you only want to give people the option to update a subset of columns, or update columns in multiple tables, you can write a [custom action](./custom.md).
@@ -62,7 +62,7 @@ Because basic actions are made of magic, you cannot archive them. You can just t
## Basic actions from object detail view
-If you have basic actions enabled for a model, you can click on an individual record to view its object detail. From that object detail model, you can click on the ellipses (**...**) and select update or delete to modify that specific record.
+If you have basic actions enabled for a model, you can click on an individual record to view its object detail. From that object detail modal, you can click on the ellipses (**...**) and select update or delete to modify that specific record.
![Update record from object detail view](./images/update-record.png)
diff --git a/docs/actions/introduction.md b/docs/actions/introduction.md
index 54400dc1fd0..2bf05ccc994 100644
--- a/docs/actions/introduction.md
+++ b/docs/actions/introduction.md
@@ -55,7 +55,7 @@ There are multiple ways to run actions:
Just something to clarify here: actions, even though they are added to models, make their changes to the underlying table that a model queries. Which means that anyone who has access to the underlying table, or to questions or other models based on that table, will be able to see the effects of an action. Tools other than Metabase that are connected to that database will also pick up these changes.
-In this sense, models are containers for actions; models are a way to organize actions. In fact, you could (in theory) add a [custom action](./custom.md) to a model that performs some update unrelated to its model's data. For example, you could write a custom action that updates the `Accounts` table, and add that action to a model that only queries an unrelated table (e.g., the `Orders` table). But, you know, maybe don't do that (unless you have a good reason). [Basic actions](./basic.md), however, are only be available for models that wrap a single raw table.
+In this sense, models are containers for actions; models are a way to organize actions. In fact, you could (in theory) add a [custom action](./custom.md) to a model that performs some update unrelated to its model's data. For example, you could write a custom action that updates the `Accounts` table, and add that action to a model that only queries an unrelated table (e.g., the `Orders` table). But, you know, maybe don't do that (unless you have a good reason). [Basic actions](./basic.md), however, are only available for models that wrap a single raw table.
Before using actions in production, consider playing around with actions on some sample data (like the Sample Database included with Metabase) to get a feel for how they work.
diff --git a/docs/ai/metabot-slack.md b/docs/ai/metabot-slack.md
index 96a9f31eee7..74b2d2a4c80 100644
--- a/docs/ai/metabot-slack.md
+++ b/docs/ai/metabot-slack.md
@@ -32,7 +32,7 @@ This is the basic Slack integration that lets Metabase send alerts and subscript
### 3. Enable natural language questions
-This is the setting lets people chat with Metabot in Slack.
+This is the setting that lets people chat with Metabot in Slack.
Follow the steps in [Set up Metabot in Slack](../configuring-metabase/slack.md#set-up-metabot-in-slack) to add your Slack app credentials.
diff --git a/docs/cloud/accounts-and-billing.md b/docs/cloud/accounts-and-billing.md
index 4df999cc79b..685cecfc91b 100644
--- a/docs/cloud/accounts-and-billing.md
+++ b/docs/cloud/accounts-and-billing.md
@@ -98,7 +98,7 @@ See Metabase's updated [W9 form](https://www.metabase.com/files/2024_W9_signed.p
## Update your Tax ID
1. Log in to your Metabase [Store account](https://store.metabase.com).
-2. Go to on **Billing**.
+2. Go to **Billing**.
3. Click on **Invoice Tax IDs**.
4. Enter your country and Tax ID.
5. Click **Save**.
diff --git a/docs/cloud/migrate/cloud-to-self-hosted.md b/docs/cloud/migrate/cloud-to-self-hosted.md
index b52aa07ac9c..b6c6c930d22 100644
--- a/docs/cloud/migrate/cloud-to-self-hosted.md
+++ b/docs/cloud/migrate/cloud-to-self-hosted.md
@@ -48,7 +48,7 @@ If you're migrating from a Metabase Cloud Pro plan to a self-hosted Pro plan, yo
2. **Download the snapshot from Metabase Store**. The email from Metabase Success Engineering will have a link to your download. You'll need to log in to the Metabase Store to access the download.
- The snapshot of your Metabase Cloud application database will be an H2 file database: a file with the extension `.mv.db`. (Metabase Cloud instances use PostgreSQL for application databases, but snapshots are saved in H2 format, so that you can restore to either PostgreSQL or MysQL application databases).
+ The snapshot of your Metabase Cloud application database will be an H2 file database: a file with the extension `.mv.db`. (Metabase Cloud instances use PostgreSQL for application databases, but snapshots are saved in H2 format, so that you can restore to either PostgreSQL or MySQL application databases).
Snapshots expire quickly, but don't sweat it; if your snapshot has expired, just request a new one.
diff --git a/docs/cloud/migrate/guide.md b/docs/cloud/migrate/guide.md
index 5efe8edc499..f892593c31a 100644
--- a/docs/cloud/migrate/guide.md
+++ b/docs/cloud/migrate/guide.md
@@ -50,7 +50,7 @@ Once the snapshot upload completes:
### Set up your account and choose your plan and deployment
-While Metabase prepping the migration, click on the **Go to Metabase Store** button to sign in to or set up your account.
+While Metabase is prepping the migration, click on the **Go to Metabase Store** button to sign in to or set up your account.
Choose your plan: [Starter](https://www.metabase.com/product/starter) or [Pro](https://www.metabase.com/product/pro). You can choose monthly or annual billing (annual will save you 10%).
@@ -72,7 +72,7 @@ Welcome to Metabase Cloud!
When migrating, you may get an automatic upgrade. If the current version of Metabase Cloud is higher than the version you were using, your Metabase will be upgraded automatically to the higher version.
-If the default version on Metabase Cloud is the same or lower than your current version, you're migration will maintain the same version you've been running.
+If the default version on Metabase Cloud is the same or lower than your current version, your migration will maintain the same version you've been running.
## Follow up after the migration
diff --git a/docs/configuring-metabase/custom-maps.md b/docs/configuring-metabase/custom-maps.md
index a1c847179f8..2a4dff2493a 100644
--- a/docs/configuring-metabase/custom-maps.md
+++ b/docs/configuring-metabase/custom-maps.md
@@ -61,7 +61,7 @@ To add a custom map:
- **Name of the map** will be displayed in the region selector for [custom region maps](../questions/visualizations/map.md#custom-regions).
- **Region's identifier** is a GeoJSON field that identifies your region. The values in this field should match how the data refers to the regions. The field doesn't need to match the display name .
- - **Region's display name** is a GeoJSON field that specifies how maps will display region names. This field can be different from region's identifier.
+ - **Region's display name** is a GeoJSON field that specifies how maps will display region names. This field can be different from the region's identifier.
To pre-load one or more region maps when Metabase starts, you can use the environment variable [`MB_CUSTOM_GEOJSON`](./environment-variables.md#mb_custom_geojson) or a [config file option](./config-file.md) `custom-geojson` .
diff --git a/docs/configuring-metabase/email.md b/docs/configuring-metabase/email.md
index 920fb0baac6..63d1194680c 100644
--- a/docs/configuring-metabase/email.md
+++ b/docs/configuring-metabase/email.md
@@ -169,7 +169,7 @@ People with [row or column restrictions](../permissions/row-and-column-security.
1. In the **SMTP Host** field, enter `smtp.gmail.com`.
2. Fill in 465 for the **SMTP Port** field.
3. For the **SMTP Security**, select **SSL**.
-4. In the **SMTP UsernameE** field, enter your Google Apps email address (e.g. `[email protected]`).
+4. In the **SMTP Username** field, enter your Google Apps email address (e.g. `[email protected]`).
5. Enter your Google Apps password in the **SMTP Password** field.
6. Enter the email address you would like to be used as the sender of system notifications in the **From address** field.
diff --git a/docs/configuring-metabase/localization.md b/docs/configuring-metabase/localization.md
index 992cb87adb1..0907d1129ef 100644
--- a/docs/configuring-metabase/localization.md
+++ b/docs/configuring-metabase/localization.md
@@ -107,7 +107,7 @@ To configure default separator settings:
_Admin > Settings > Localization_
-You can choose how should currency fields be displayed by default (you can to configure _which_ fields should be displayed as currency in table metadata or in question formatting setting, see [Formatting](../data-modeling/formatting.md) )
+You can choose how should currency fields be displayed by default (you can configure _which_ fields should be displayed as currency in table metadata or in question formatting setting, see [Formatting](../data-modeling/formatting.md) )
Note that people can also override these localization options for specific fields or questions.
diff --git a/docs/configuring-metabase/log-configuration.md b/docs/configuring-metabase/log-configuration.md
index d876d7f8213..09f5c2ad8c0 100644
--- a/docs/configuring-metabase/log-configuration.md
+++ b/docs/configuring-metabase/log-configuration.md
@@ -13,7 +13,7 @@ Metabase logs quite a bit of information by default. Metabase uses [Log4j 2](htt
You can find Metabase logs in **Admin** > **Tools** > **Logs**. You can filter the logs by keywords (for example, "sync") and download them as a text file.
-If you're running self-hosted Metabase, you'll also be able see the logs in the terminal.
+If you're running self-hosted Metabase, you'll also be able to see the logs in the terminal.
## How to read Metabase logs
diff --git a/docs/configuring-metabase/setting-up-metabase.md b/docs/configuring-metabase/setting-up-metabase.md
index 5cb2be85d9a..dbe2a5626ad 100644
--- a/docs/configuring-metabase/setting-up-metabase.md
+++ b/docs/configuring-metabase/setting-up-metabase.md
@@ -36,7 +36,7 @@ Don't worry about picking the wrong option. If you say you're interested in embe
## Gathering your database info
-At this point you’ll need to gather some information about the database you want to use with Metabase. We won’t be able to connect to your database without it, but you’d like to deal with all of this later, that’s okay: just click **I’ll add my data later**. Metabase comes with a [Sample Database](https://www.metabase.com/glossary/sample-database) that you can play around with to get a feel for how Metabase works.
+At this point you’ll need to gather some information about the database you want to use with Metabase. We won’t be able to connect to your database without it, but if you’d like to deal with all of this later, that’s okay: just click **I’ll add my data later**. Metabase comes with a [Sample Database](https://www.metabase.com/glossary/sample-database) that you can play around with to get a feel for how Metabase works.
If you’re ready to connect, here’s what you’ll need:
diff --git a/docs/configuring-metabase/settings.md b/docs/configuring-metabase/settings.md
index 3b971493d85..37e9f22415f 100644
--- a/docs/configuring-metabase/settings.md
+++ b/docs/configuring-metabase/settings.md
@@ -42,7 +42,7 @@ This email address will be displayed in various messages throughout Metabase whe
## Anonymous tracking
-On self-hosted Metabases, this option turns determines whether or not you allow [anonymous data about your usage of Metabase](../installation-and-operation/information-collection.md) to be sent back to us to help us improve the product. [Your database’s data is never tracked or sent](https://www.metabase.com/security).
+On self-hosted Metabases, this option determines whether or not you allow [anonymous data about your usage of Metabase](../installation-and-operation/information-collection.md) to be sent back to us to help us improve the product. [Your database’s data is never tracked or sent](https://www.metabase.com/security).
## Friendly table and field names
diff --git a/docs/configuring-metabase/timezones.md b/docs/configuring-metabase/timezones.md
index 71cd0e5b4d1..b413e40cfea 100644
--- a/docs/configuring-metabase/timezones.md
+++ b/docs/configuring-metabase/timezones.md
@@ -44,7 +44,7 @@ The exact data type will depend on your database. Some Metabase features only wo
## Common pitfalls
-1. Your database is using date/time columns without any timezone information. Typically when this happens your database will assume all the data is from whatever timezone the database is configured in or possible just default to UTC (check your database vendor to be sure).
+1. Your database is using date/time columns without any timezone information. Typically when this happens your database will assume all the data is from whatever timezone the database is configured in or possibly just default to UTC (check your database vendor to be sure).
2. Your JVM timezone is different from your Metabase `Report Timezone` choice. This is a common issue and can be corrected by launching java with the `-Duser.timezone=<timezone>` option properly set to match your Metabase report timezone.
If you are still experiencing timezone problems, then have a look at the [timezone troubleshooting guide](../troubleshooting-guide/timezones.md).
diff --git a/docs/dashboards/filters.md b/docs/dashboards/filters.md
index 2f3318f01ae..2a79d648c82 100644
--- a/docs/dashboards/filters.md
+++ b/docs/dashboards/filters.md
@@ -235,7 +235,7 @@ Renaming the filter only affects the filter's display; the label has no effect o
### Change filter or parameter type
-You can change the [type](#filter-types) or an existing filter (for example, from a Date filter to a Text filter). Any incompatible columns connected to the widget will be disconnected.
+You can change the [type](#filter-types) of an existing filter (for example, from a Date filter to a Text filter). Any incompatible columns connected to the widget will be disconnected.
To change the widget type:
diff --git a/docs/dashboards/introduction.md b/docs/dashboards/introduction.md
index a2db05a6aec..5d771b7c216 100644
--- a/docs/dashboards/introduction.md
+++ b/docs/dashboards/introduction.md
@@ -175,7 +175,7 @@ You can add multiple tabs to a dashboard to keep your cards organized.
### Duplicate a tab
-When in dashboard edit mode, you can duplicate a tab and all the its cards by clicking on the down arrow next to the tab that you want to copy.
+When in dashboard edit mode, you can duplicate a tab and all its cards by clicking on the down arrow next to the tab that you want to copy.
### Moving cards between tabs
diff --git a/docs/dashboards/subscriptions.md b/docs/dashboards/subscriptions.md
index a04dd1d638e..73444e8a2b4 100644
--- a/docs/dashboards/subscriptions.md
+++ b/docs/dashboards/subscriptions.md
@@ -19,7 +19,7 @@ To enable dashboard subscriptions, your administrators will need to have set up
To set up a subscription to a dashboard,
-1. Click on the **three dots** icon Select **Subscriptions**.
+1. Click on the **three dots** icon. Select **Subscriptions**.
![Select subscriptions from menu](./images/select-subscriptions.png)
@@ -33,7 +33,7 @@ To set up a subscription to a dashboard,
#### Email
-You can sent email subscriptions both to people who have Metabase accounts (by typing their names) and to people outside Metabase (by typing their email).
+You can send email subscriptions both to people who have Metabase accounts (by typing their names) and to people outside Metabase (by typing their email).
On Metabase [Pro](https://www.metabase.com/product/pro) and [Enterprise](https://www.metabase.com/product/enterprise), admins can limit email recipients to [approved domains for notifications](../configuring-metabase/email.md#approved-domains-for-notifications) and [configure which recipients Metabase suggests](../configuring-metabase/email.md#suggest-recipients-on-dashboard-subscriptions-and-alerts).
@@ -55,7 +55,7 @@ You can tell Metabase how often it should send the dashboard:
- Weekly
- Monthly
-You'll need to specify what time of day to send the dashboard, and, for weekly and monthly subscription, the day when to send the subscription.
+You'll need to specify what time of day to send the dashboard, and, for weekly and monthly subscriptions, the day when to send the subscription.
### Test subscription
@@ -79,7 +79,7 @@ This is helpful for dashboards that are displaying time-limited results (for exa
When configuring an email subscription, you can tell Metabase if it should attach results to the email as a file, in addition to displaying the table in the email body.
-Currently, you can only send attachments with question results. You can't sent the whole dashboard as a PDF attachment.
+Currently, you can only send attachments with question results. You can't send the whole dashboard as a PDF attachment.
If you've added filters to your dashboard and set default values for those filters, Metabase will apply those default values to your subscriptions, filtering the results of all questions that are connected to those filters when the subscriptions are sent. To learn more, check out [dashboard filters](./filters.md).
diff --git a/docs/data-modeling/formatting.md b/docs/data-modeling/formatting.md
index 53c8ba7c881..88c87af3b02 100644
--- a/docs/data-modeling/formatting.md
+++ b/docs/data-modeling/formatting.md
@@ -21,7 +21,7 @@ You can override the global defaults for a specific field by going to the `Table
## Formatting options depend on the data type and the semantic type
-The options you'll see here will depend on the field's data type and it's [semantic type](./semantic-types.md).
+The options you'll see here will depend on the field's data type and its [semantic type](./semantic-types.md).
## Text formatting options
diff --git a/docs/data-modeling/metadata-editing.md b/docs/data-modeling/metadata-editing.md
index ee861e828b2..aa399f89967 100644
--- a/docs/data-modeling/metadata-editing.md
+++ b/docs/data-modeling/metadata-editing.md
@@ -28,7 +28,7 @@ You can search for tables, or use the tree navigation to find each of your conne
To edit a table's display name or description in the table metadata tab, click into the box that contains the current table name or description and edit it. Changes will be saved automatically once you click out of the box.
-Descriptions are displayed in Metabase's [data reference](../exploration-and-organization/data-model-reference.md) and tooltips when view the table. Decscriptions help people find the right table for their use case.
+Descriptions are displayed in Metabase's [data reference](../exploration-and-organization/data-model-reference.md) and tooltips when viewing the table. Descriptions help people find the right table for their use case.
### Table sync options
diff --git a/docs/data-modeling/metrics.md b/docs/data-modeling/metrics.md
index 28eae712de7..13e257dd945 100644
--- a/docs/data-modeling/metrics.md
+++ b/docs/data-modeling/metrics.md
@@ -83,7 +83,7 @@ To edit a metric:
![Metric definition](./images/metric-definition.png)
- If you edit metric's definition, all questions that use the metric will immediately start using the new definition.
+ If you edit the metric's definition, all questions that use the metric will immediately start using the new definition.
3. Save your changes.
diff --git a/docs/data-modeling/model-persistence.md b/docs/data-modeling/model-persistence.md
index 0a7878d855e..4415d1bfefb 100644
--- a/docs/data-modeling/model-persistence.md
+++ b/docs/data-modeling/model-persistence.md
@@ -54,7 +54,7 @@ Once you've turned on model persistence for your Metabase, you'll need to set it
4. Ensure that the credentials Metabase uses to connect to your data warehouse can manage and write to that schema.
-By default, new models on the database will _not_ b persisted. You need to [Turn on model persistence for individual models](#turn-on-model-persistence-for-individual-models).
+By default, new models on the database will _not_ be persisted. You need to [Turn on model persistence for individual models](#turn-on-model-persistence-for-individual-models).
## Turn on model persistence for individual models
diff --git a/docs/data-studio/data-structure.md b/docs/data-studio/data-structure.md
index a7f61ef93e6..f270e2a614b 100644
--- a/docs/data-studio/data-structure.md
+++ b/docs/data-studio/data-structure.md
@@ -24,7 +24,7 @@ You can do things like:
## Permissions for Data Structure
-To access the Data Structure area of Data Studio, you need to be a members of the Admin group or the Data Analyst group (Data Analyst group is only available on Pro/Enterprise plans).
+To access the Data Structure area of Data Studio, you need to be a member of the Admin group or the Data Analyst group (Data Analyst group is only available on Pro/Enterprise plans).
People in the Data Analyst group will have table metadata and data structure access to _all_ tables in your Metabase, even if they have limited View Data permissions for those tables. If you only want to give someone access to table metadata for some - but not all - tables, use the table metadata permissions and access the Table Metadata through Admin > Table metadata instead of Data Studio.
@@ -74,7 +74,7 @@ The options are:
- **Internal**: table visible in the query builder and synced.
- **Final**: table is visible in the query builder and synced.
-Table visibility layer can be used as a tool to improve user experience of people working in you Metabase, and it should _not be used to control access_ - use [data permissions](../permissions/data.md) to control access instead.
+Table visibility layer can be used as a tool to improve user experience of people working in your Metabase, and it should _not be used to control access_ - use [data permissions](../permissions/data.md) to control access instead.
### Entity type
@@ -143,7 +143,7 @@ To see all measures on a table, select the table in **Data structure** and switc
### Use a measure in the query builder
-To use a measure in the query builder, start a new question from the table that the measure is based on, and select the measure in the **Summarize** block. Measure's saved aggregation will be applied behind the scenes. You can use breakouts with a saved measure.
+To use a measure in the query builder, start a new question from the table that the measure is based on, and select the measure in the **Summarize** block. The measure's saved aggregation will be applied behind the scenes. You can use breakouts with a saved measure.
### Delete a measure
diff --git a/docs/data-studio/transforms/transforms-overview.md b/docs/data-studio/transforms/transforms-overview.md
index 0f34c31712e..28a4349e14e 100644
--- a/docs/data-studio/transforms/transforms-overview.md
+++ b/docs/data-studio/transforms/transforms-overview.md
@@ -224,7 +224,7 @@ You can check your transforms into git with [Remote Sync](../../installation-and
To enable git sync of transforms:
-1. Go to Admin settings by click the **grid** icon in top right and select **Admin**.
+1. Go to Admin settings by clicking the **grid** icon in top right and select **Admin**.
2. On the **General** tab, pick **Remote sync** in the left sidebar.
3. Follow the steps to [Set up Remote Sync](../../installation-and-operation/remote-sync.md), and toggle "Transforms" sync on.
diff --git a/docs/databases/connections/starburst.md b/docs/databases/connections/starburst.md
index 1c53a069966..20a2c9a003a 100644
--- a/docs/databases/connections/starburst.md
+++ b/docs/databases/connections/starburst.md
@@ -39,7 +39,7 @@ The database port (e.g., `8080`).
### Catalog
-Starburt catalogs contain schemas and reference data sources via a connector.
+Starburst catalogs contain schemas and reference data sources via a connector.
### Schema (optional)
diff --git a/docs/developers-guide/api-changelog.md b/docs/developers-guide/api-changelog.md
index 9c63b43b5b6..f9eee87e2d8 100644
--- a/docs/developers-guide/api-changelog.md
+++ b/docs/developers-guide/api-changelog.md
@@ -20,7 +20,7 @@ title: API changelog
## Metabase 0.56.13
- `/api/collection/graph` endpoints now no longer return 'none' permissions in the returned graph. Missing fields in
- between group ids and collection id indicate that that the group provides no permissions for the collection. For
+ between group ids and collection id indicate that the group provides no permissions for the collection. For
example, what was returned in versions before 0.56.13:
```json
{"revision": 2, "groups": {"1": {"root": "write", "1": "read", "2": "none"}}}
diff --git a/docs/embedding/appearance.md b/docs/embedding/appearance.md
index fa62620b292..a2874eede29 100644
--- a/docs/embedding/appearance.md
+++ b/docs/embedding/appearance.md
@@ -38,7 +38,7 @@ On Pro/Enterprise plan, you can configure granular appearance options, like back
![Behavior and appearance](./images/behavior-and-appearance.png)
-Some appearance options like brand, text, and background color are configurable in in the [embed wizard](./modular-embedding.md#create-a-new-embed).
+Some appearance options like brand, text, and background color are configurable in the [embed wizard](./modular-embedding.md#create-a-new-embed).
For other appearance settings, use the `theme` parameter with `preset` in the `defineMetabaseConfig()` function in your [embedding code snippet](./modular-embedding.md#add-the-embedding-script-to-your-app). For example:
diff --git a/docs/embedding/authentication.md b/docs/embedding/authentication.md
index b2ba7c845d5..c4e214cf64b 100644
--- a/docs/embedding/authentication.md
+++ b/docs/embedding/authentication.md
@@ -283,7 +283,7 @@ app.get("/sso/metabase", async (req, res) => {
## Embedding Metabase in a different domain
-{% include plans-blockquote.html feature="Authenticated modular embeds" convert_pro_link_to_embbedding=true is_plural=true %}
+{% include plans-blockquote.html feature="Authenticated modular embeds" convert_pro_link_to_embedding=true is_plural=true %}
This section applies only to **authenticated embeds**. Guest embeds work cross-domain without additional configuration.
diff --git a/docs/embedding/components.md b/docs/embedding/components.md
index 61624a3f67d..5eb6d6c8306 100644
--- a/docs/embedding/components.md
+++ b/docs/embedding/components.md
@@ -75,7 +75,7 @@ For example, to embed the SQL editor:
## Browser
-{% include plans-blockquote.html feature="Browser component" convert_pro_link_to_embbedding=true%}
+{% include plans-blockquote.html feature="Browser component" convert_pro_link_to_embedding=true%}
Browser component is only available for authenticated modular embeds. It's unavailable for [Guest embeds](./guest-embedding.md).
@@ -96,7 +96,7 @@ To render a collection browser so people can navigate a collection and open dash
## AI chat
-{% include plans-blockquote.html feature="AI chat component" convert_pro_link_to_embbedding=true%}
+{% include plans-blockquote.html feature="AI chat component" convert_pro_link_to_embedding=true%}
AI chat component is only available for authenticated modular embeds. It's unavailable for [Guest embeds](./guest-embedding.md).
@@ -112,7 +112,7 @@ To render the AI chat interface:
## Customizing loader and error components
-{% include plans-blockquote.html feature="Customizing loader and error componentst" convert_pro_link_to_embbedding=true%}
+{% include plans-blockquote.html feature="Customizing loader and error components" convert_pro_link_to_embedding=true%}
If you're using the [modular embedding SDK](./sdk/introduction.md), you can provide your own components for loading and error states by specifying `loaderComponent` and `errorComponent` as props to `MetabaseProvider`.
diff --git a/docs/embedding/full-app-embedding-quick-start-guide.md b/docs/embedding/full-app-embedding-quick-start-guide.md
index e5cbef3ffee..5cd43abcea9 100644
--- a/docs/embedding/full-app-embedding-quick-start-guide.md
+++ b/docs/embedding/full-app-embedding-quick-start-guide.md
@@ -16,7 +16,7 @@ You'll embed the full Metabase application in your app. Once logged in, people c
## Prerequisites
-{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embbedding=true%}
+{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embedding=true%}
- You have an app that you can embed Metabase in.
- You have a Pro or Enterprise subscription of Metabase. If you're unsure where to start, sign up for a free trial for [Pro On-Prem](https://store.metabase.com/checkout/embedding). If you have Docker Desktop installed, you can just search for "metabase-enterprise" to find the Docker image and run it. Alternatively, you can follow [these instructions](../installation-and-operation/running-metabase-on-docker.md#pro-or-enterprise-quick-start).
diff --git a/docs/embedding/full-app-embedding.md b/docs/embedding/full-app-embedding.md
index 924e8e44c10..78f33e88ca0 100644
--- a/docs/embedding/full-app-embedding.md
+++ b/docs/embedding/full-app-embedding.md
@@ -8,7 +8,7 @@ redirect_from:
# Full app embedding
-{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embbedding=true %}
+{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embedding=true %}
{% include shared/in-page-promo-embedding-workshop.html %}
@@ -75,7 +75,7 @@ To embed a specific Metabase dashboard, you'll want to use the dashboard's Entit
src="https://metabase.yourcompany.com/dashboard/entity/[Entity ID]"
```
-To get a dashboard's Entity ID, visit the dashboard and click on the **info** button. In the **Overview** tab, copy the **Entity ID**. Then in your iframe's `src` attribute to:
+To get a dashboard's Entity ID, visit the dashboard and click on the **info** button. In the **Overview** tab, copy the **Entity ID**. Then set your iframe's `src` attribute to:
```
src=https://metabase.yourcompany.com/dashboard/entity/Dc_7X8N7zf4iDK9Ps1M3b
diff --git a/docs/embedding/full-app-ui-components.md b/docs/embedding/full-app-ui-components.md
index 120e35be7f9..66ebc82571f 100644
--- a/docs/embedding/full-app-ui-components.md
+++ b/docs/embedding/full-app-ui-components.md
@@ -7,7 +7,7 @@ redirect_from:
# Full app embedding UI components
-{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embbedding=true%}
+{% include plans-blockquote.html feature="Full app embedding" convert_pro_link_to_embedding=true%}
To change the interface of your full app embed, you can add parameters to the end of your embedding URL. If you want to change the colors or fonts in your embed, see [Customizing appearance](../configuring-metabase/appearance.md).
diff --git a/docs/embedding/modular-embedding.md b/docs/embedding/modular-embedding.md
index 32992c7ae27..72f188eb951 100644
--- a/docs/embedding/modular-embedding.md
+++ b/docs/embedding/modular-embedding.md
@@ -51,7 +51,7 @@ You can also go to **Admin > Embedding > Modular embedding** and click **New emb
### 2. Pick how to authenticate the embed
-{% include plans-blockquote.html feature="Authenticated modular embedding" convert_pro_link_to_embbedding=true %}
+{% include plans-blockquote.html feature="Authenticated modular embedding" convert_pro_link_to_embedding=true %}
With SSO, Metabase can know who is viewing the embed, and it can unlock all of its bells and whistles (see this [comparison between SSO and guest embeds](./introduction.md#comparison-of-embedding-types)).
@@ -63,9 +63,9 @@ The exact customization options you see will depend on what type of entity you'r
![Embed flow options for AI chat](./images/embed-flow-options.png)
-If you are on Metabase OSS/Starter plans, you'll be able to select light or dark themes for your components. On Metabase Pro/Enterprise, you'll be also be able to pick specific colors for brand, text, and background in the embed wizard, and add more customization options through [appearance settings](./appearance.md) later.
+If you are on Metabase OSS/Starter plans, you'll be able to select light or dark themes for your components. On Metabase Pro/Enterprise, you'll also be able to pick specific colors for brand, text, and background in the embed wizard, and add more customization options through [appearance settings](./appearance.md) later.
-All the customization options you select in this wizard will be reflected in code snippet that the embed wizard will generate for you, and you'll be able to add more options later.
+All the customization options you select in this wizard will be reflected in the code snippet that the embed wizard will generate for you, and you'll be able to add more options later.
For example, this code defines the font, color, and size for text, background colors, and colors for filters and summaries:
@@ -98,10 +98,10 @@ If you [create an embed through the built-in embed wizard](#create-a-new-embed),
You'll add this code snippet to your app and refresh the page.
-The code snippets:
+The code snippet has three parts:
- Loading the modular embedding library from your Metabase instance.
-- Set global configuration settings, like the URL of your Metabase and the `theme`. See [Page-level config](#page-level-config).
+- Setting global configuration settings, like the URL of your Metabase and the `theme`. See [Page-level config](#page-level-config).
- The component(s) to embed, with their parameters. See [Components](./components.md).
Here's an example snippet:
@@ -142,7 +142,7 @@ If you're embedding multiple components in a single page, you only need to inclu
## Each end user should have their own Metabase account
-{% include plans-blockquote.html feature="Modular embedding with SSO" convert_pro_link_to_embbedding=true %}
+{% include plans-blockquote.html feature="Modular embedding with SSO" convert_pro_link_to_embedding=true %}
With SSO embeds, each end-user must have their own Metabase account. If you can't provision accounts for every end user, you have to use [Guest embeds](./guest-embedding.md) instead.
@@ -156,7 +156,7 @@ In addition to this, we consider shared accounts to be unfair usage. Fair usage
The exact customization options you see will depend on which type of entity you're embedding. These are the settings for authenticated embeds available on [Pro](https://www.metabase.com/product/pro) and [Enterprise](https://www.metabase.com/product/enterprise) plans. For guest embeds (OSS and paid), see [guest embedding options](./guest-embedding.md#component-attributes).
-When you're creating a new embed using **Admin > Embedding > Setup guide > Embed in your code**, you'll see some or all the following customization options in the interactive creation flow. These options correspond to parameters in [components](./components.md).
+When you're creating a new embed using **Admin > Embedding > Setup guide > Embed in your code**, you'll see some or all of the following customization options in the interactive creation flow. These options correspond to parameters in [components](./components.md).
- **Allow people to drill through on data points**: determines whether people can interact with the chart (or charts on a dashboard). Interactivity includes [drilling down](https://www.metabase.com/learn/metabase-basics/querying-and-dashboards/questions/drill-through) to individual records from aggregated questions, filtering on click, zooming in, etc. Disabling drill-through for an embedded _question_ also disables people's ability to add filters and summaries.
diff --git a/docs/embedding/sdk/ai-chat.md b/docs/embedding/sdk/ai-chat.md
index 4ed0705c15d..4c6fe2be7a9 100644
--- a/docs/embedding/sdk/ai-chat.md
+++ b/docs/embedding/sdk/ai-chat.md
@@ -7,7 +7,7 @@ summary: Embed an AI chat component in your app that can create queries from nat
![Embedded AI chat](../images/ai-chat.png)
-{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true %}
+{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embedding=true%}
You can embed an AI chat in your application similar to [Metabot](../modular-embedding.md) in Metabase.
diff --git a/docs/embedding/sdk/collections.md b/docs/embedding/sdk/collections.md
index 113663b2429..fb48c55061f 100644
--- a/docs/embedding/sdk/collections.md
+++ b/docs/embedding/sdk/collections.md
@@ -5,7 +5,7 @@ summary: Embed Metabase collection browser in your application using the Metabas
# Modular embedding SDK - collections
-{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true %}
+{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embedding=true %}
## Embedding a collection browser
diff --git a/docs/embedding/sdk/questions.md b/docs/embedding/sdk/questions.md
index 260f1ce9712..e3f2b10e2e6 100644
--- a/docs/embedding/sdk/questions.md
+++ b/docs/embedding/sdk/questions.md
@@ -5,7 +5,7 @@ description: How to embed charts in your app with the Modular embedding SDK.
# Modular embedding SDK - questions
-{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true %}
+{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embedding=true%}
There are different ways you can embed questions:
diff --git a/docs/embedding/sdk/quickstart-cli.md b/docs/embedding/sdk/quickstart-cli.md
index a43c2c5c004..a17514f6c9f 100644
--- a/docs/embedding/sdk/quickstart-cli.md
+++ b/docs/embedding/sdk/quickstart-cli.md
@@ -5,7 +5,7 @@ summary: Get started with the Modular embedding SDK using a single CLI command.
# Modular embedding SDK - CLI quickstart
-{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embbedding=true %}
+{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embedding=true %}
We built a single command to spin up a Metabase and help you get an embedded dashboard in your app. This setup with API keys won't work in production; it's only intended for you to quickly try out the SDK on your local machine. A production setup requires a Pro/Enterprise license, and SSO with JWT.
diff --git a/docs/embedding/sdk/quickstart-with-sample-app.md b/docs/embedding/sdk/quickstart-with-sample-app.md
index 00d70a24e65..a718404ca90 100644
--- a/docs/embedding/sdk/quickstart-with-sample-app.md
+++ b/docs/embedding/sdk/quickstart-with-sample-app.md
@@ -5,7 +5,7 @@ summary: Set up the Modular embedding SDK with a sample React app and JWT authen
# Modular embedding SDK - quickstart with sample app
-{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embbedding=true %}
+{% include plans-blockquote.html feature="Modular embedding SDK" sdk=true convert_pro_link_to_embedding=true %}
This guide sets up the modular embedding SDK with a [sample React app](https://github.com/metabase/metabase-nodejs-react-sdk-embedding-sample/tree/{{page.version | remove: "v0."}}-stable), but you can follow along with your own application.
diff --git a/docs/embedding/securing-embeds.md b/docs/embedding/securing-embeds.md
index 8f43768bd11..9f678af1ad7 100644
--- a/docs/embedding/securing-embeds.md
+++ b/docs/embedding/securing-embeds.md
@@ -217,7 +217,7 @@ To set up these multi-tenant permissions, we'll need to:
- People with `role=customer` are assigned to the Customers group.
5. Set up row-level security on the Accounts table for each group:
- For the Customers group, the Accounts table will be restricted with `Account ID = primary_id`.
- - For the Tenants group,, the Accounts table will be restricted with `Tenant ID = primary_id`.
+ - For the Tenants group, the Accounts table will be restricted with `Tenant ID = primary_id`.
When Tenant A logs in with SSO for the first time:
diff --git a/docs/embedding/translations.md b/docs/embedding/translations.md
index dde00e218e7..e85c794343f 100644
--- a/docs/embedding/translations.md
+++ b/docs/embedding/translations.md
@@ -5,7 +5,7 @@ summary: Upload a translation dictionary to translate the UI and content of embe
# Translate embedded components
-{% include plans-blockquote.html feature="Translation of embedded content" convert_pro_link_to_embbedding=true %}
+{% include plans-blockquote.html feature="Translation of embedded content" convert_pro_link_to_embedding=true %}
You can set a locale on modular embeds (guest, SSO, and SDK) to translate Metabase's UI. If you've uploaded a translation dictionary, Metabase will also translate content strings (like dashboard names and filter labels) for all [modular embeds](./modular-embedding.md).
@@ -24,7 +24,7 @@ For guest and SSO embeds (not the SDK), set the `locale` in `window.metabaseConf
// If you've uploaded a translation dictionary,
// Metabase will also translate content strings
// to this locale from that dictionary.
- locale: "es"
+ locale: "es",
};
</script>
@@ -38,11 +38,7 @@ If you also want to translate content (like item titles, headings, filter labels
For the SDK, set the `locale` prop on the `MetabaseProvider` component:
```tsx
-<MetabaseProvider
- authConfig={authConfig}
- locale="es"
->
-</MetabaseProvider>
+<MetabaseProvider authConfig={authConfig} locale="es"></MetabaseProvider>
```
If you've uploaded a translation dictionary, the SDK will also translate content strings (like dashboard names and filter labels) to this locale from that dictionary.
@@ -111,7 +107,6 @@ If the strings you want to translate include markdown formatting, you'll need to
| pt-BR | `_Examples_` | `_Exemplos_` |
| pt-BR | `## Examples` | `## Exemplos` |
-
## The AI chat component isn't translated
One exception is that Metabase won't translate the text in the [AI chat component](./sdk/ai-chat.md). While Metabot can understand other languages, it works best in English.
diff --git a/docs/exploration-and-organization/content-verification.md b/docs/exploration-and-organization/content-verification.md
index e2de410e8d8..74878e54771 100644
--- a/docs/exploration-and-organization/content-verification.md
+++ b/docs/exploration-and-organization/content-verification.md
@@ -47,7 +47,7 @@ Admins can verify the following items:
- [Metrics](../data-modeling/metrics.md)
- [Dashboards](../dashboards/introduction.md)
-Dashboard verification status has no affect on its questions. Questions must be verified independently.
+Dashboard verification status has no effect on its questions. Questions must be verified independently.
## Further reading
diff --git a/docs/exploration-and-organization/delete-and-restore.md b/docs/exploration-and-organization/delete-and-restore.md
index f71d383d7ca..c55680c98bc 100644
--- a/docs/exploration-and-organization/delete-and-restore.md
+++ b/docs/exploration-and-organization/delete-and-restore.md
@@ -56,7 +56,7 @@ To restore an item:
> Restoring a collection will also restore all the items from that collection.
-If the item's original parent collection has been deleted as well, you won't see an option to **Restore**. You'll still be able to move the it from Trash to a different collection.
+If the item's original parent collection has been deleted as well, you won't see an option to **Restore**. You'll still be able to move it from Trash to a different collection.
### Cleaning up collections
diff --git a/docs/exploration-and-organization/exploration.md b/docs/exploration-and-organization/exploration.md
index ac09835c072..1e5d4efd742 100644
--- a/docs/exploration-and-organization/exploration.md
+++ b/docs/exploration-and-organization/exploration.md
@@ -32,7 +32,7 @@ To filter your search results, hit `cmd/ctrl + k` to bring up the command palett
![Search results](./images/search-results.png)
-Searches consider items' titles, descriptions, and other metadata — you can even search the contents of your SQL queries. For example, you can search for things like `SELECT escape_pod FROM mothership` and find that one question you worked on six months ago. The results will display which collection each item is saved in, what kind of object it is, and whether it's pinned. Note that you'll only ever see items in that are in collections you have permission to view.
+Searches consider items' titles, descriptions, and other metadata — you can even search the contents of your SQL queries. For example, you can search for things like `SELECT escape_pod FROM mothership` and find that one question you worked on six months ago. The results will display which collection each item is saved in, what kind of object it is, and whether it's pinned. Note that you'll only ever see items that are in collections you have permission to view.
You can search by:
diff --git a/docs/exploration-and-organization/uploads.md b/docs/exploration-and-organization/uploads.md
index 5d7fe6db00c..1fe5612e6c4 100644
--- a/docs/exploration-and-organization/uploads.md
+++ b/docs/exploration-and-organization/uploads.md
@@ -71,7 +71,7 @@ If you [delete the uploaded table](../exploration-and-organization/uploads.md#de
## Primary key auto-generation
-When you upload a CSV, Metabase will create an a unique primary key column, called `_mb_row_id`, as the first (left-most) column of the uploaded CSV table. This `_mb_row_id` column will contain automatically generated integers. Metabase will also ignore any columns in the upload that have a name that will be in the database with the same name as the auto-generated primary key column (e.g., `_MB row-ID` in the CSV will be `_mb_row_id` or `_MB_ROW_ID` in the database).
+When you upload a CSV, Metabase will create a unique primary key column, called `_mb_row_id`, as the first (left-most) column of the uploaded CSV table. This `_mb_row_id` column will contain automatically generated integers. Metabase will also ignore any columns in the upload that have a name that will be in the database with the same name as the auto-generated primary key column (e.g., `_MB row-ID` in the CSV will be `_mb_row_id` or `_MB_ROW_ID` in the database).
If you don't want this autogenerated ID column, you can always remove the column from the model Metabase created. Visit the model, click on the info **i** icon, then **Model details**. From the model details page, click the **Edit definition** button. In the Data section of the query builder, click on the down arrow next to the table, deselect the added ID column, and save your changes.
diff --git a/docs/exploration-and-organization/x-rays.md b/docs/exploration-and-organization/x-rays.md
index 354d51d936a..c13adce630d 100644
--- a/docs/exploration-and-organization/x-rays.md
+++ b/docs/exploration-and-organization/x-rays.md
@@ -31,7 +31,7 @@ Here's an example X-ray:
Another great way to get to know your data is by X-raying your models and tables.
-- **Table X-rays**: From the left nav, click on **Browse Data**, pick a database, hover over a table card, and click the lightning bolt icon table to view an X-ray of the table.
+- **Table X-rays**: From the left nav, click on **Browse Data**, pick a database, hover over a table card, and click the lightning bolt icon to view an X-ray of the table.
- **Model X-rays**: Click on the ellipses for a model and select **X-ray this**.
## X-rays in the data reference
diff --git a/docs/installation-and-operation/migrating-from-h2.md b/docs/installation-and-operation/migrating-from-h2.md
index 6a4d8da8ae6..29d300c6872 100644
--- a/docs/installation-and-operation/migrating-from-h2.md
+++ b/docs/installation-and-operation/migrating-from-h2.md
@@ -7,7 +7,7 @@ redirect_from:
# Migrating to a production application database
-This page covers how to convert a Metabase that's been using the built-in application database, H2, to a production-ready instance PostgreSQL. For more on why you should use Postgres as your app DB, check out [How to run Metabase in production](https://www.metabase.com/learn/metabase-basics/administration/administration-and-operation/metabase-in-production).
+This page covers how to convert a Metabase that's been using the built-in application database, H2, to a production-ready instance of PostgreSQL. For more on why you should use Postgres as your app DB, check out [How to run Metabase in production](https://www.metabase.com/learn/metabase-basics/administration/administration-and-operation/metabase-in-production).
If you'd rather move to Metabase Cloud, check out [Migrate to Metabase Cloud](../cloud/migrate/guide.md).
@@ -153,13 +153,13 @@ export MB_DB_CONNECTION_URI="jdbc:postgresql://<host>:5432/metabase?user=<userna
java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar load-from-h2 /path/to/metabase.db # do not include .mv.db
```
-Metabase will start up, perform the migration (meaning, it'll take the data from the H2 file and put it into your new app db, in this a Postgres db), and then exit.
+Metabase will start up, perform the migration (meaning, it'll take the data from the H2 file and put it into your new app db, in this case a Postgres db), and then exit.
See [Configuring the application database](configuring-application-database.md).
### 6. Start a new Docker container that uses the new app db
-With your new application database populated with your Metabase data, you can start a new container and tell the Metabase in the container to connect to the appdb. The command will looks something like this:
+With your new application database populated with your Metabase data, you can start a new container and tell the Metabase in the container to connect to the appdb. The command will look something like this:
```
docker run -d -p 3000:3000 \
diff --git a/docs/installation-and-operation/monitoring-metabase.md b/docs/installation-and-operation/monitoring-metabase.md
index 1602fc566c0..b940e22fda0 100644
--- a/docs/installation-and-operation/monitoring-metabase.md
+++ b/docs/installation-and-operation/monitoring-metabase.md
@@ -58,7 +58,7 @@ Then use the hostname you specified above:
![sethostname](images/SetRemoteHostName.png)
-Your local machine must to be able to refer to the hostname you specified (which might require a hosts entry):
+Your local machine must be able to refer to the hostname you specified (which might require a hosts entry):
![addjmxhost](images/ClickAddJMXHost.png)
diff --git a/docs/installation-and-operation/running-metabase-on-docker.md b/docs/installation-and-operation/running-metabase-on-docker.md
index 115cd9938e7..f04522388d7 100644
--- a/docs/installation-and-operation/running-metabase-on-docker.md
+++ b/docs/installation-and-operation/running-metabase-on-docker.md
@@ -28,7 +28,7 @@ Then start the Metabase container:
docker run -d -p 3000:3000 --name metabase metabase/metabase
```
-This will launch an Metabase server on port 3000 by default.
+This will launch a Metabase server on port 3000 by default.
Optional: to view the logs as your Open Source Metabase initializes, run:
@@ -80,7 +80,7 @@ docker run -d -p 12345:3000 --name metabase metabase/metabase-enterprise
Metabase ships with an embedded H2 database that uses the file system to store its own application data. Meaning, if you remove the container, you'll lose your Metabase application data (your questions, dashboards, collections, and so on).
-If you want to run Metabase in production, you'll need store your application data in a [production-ready database](./migrating-from-h2.md#supported-databases-for-storing-your-metabase-application-data).
+If you want to run Metabase in production, you'll need to store your application data in a [production-ready database](./migrating-from-h2.md#supported-databases-for-storing-your-metabase-application-data).
Once you've provisioned a database, like Postgres, for Metabase to use to store its application data, all you need to do is provide Metabase with the connection information and credentials so Metabase can connect to it.
@@ -218,7 +218,7 @@ docker run -d -p 3000:3000 \
--name metabase metabase/metabase
```
-When you launch your container, Metabase will use the database file (`MB_DB_FILE`) at `~/metabase-data/metabase.db` instead of its default location. and we are mounting that folder from our local filesystem into the container.
+When you launch your container, Metabase will use the database file (`MB_DB_FILE`) at `~/metabase-data/metabase.db` instead of its default location, and we are mounting that folder from our local filesystem into the container.
### Getting your config back if you stopped your container
@@ -253,7 +253,7 @@ You should have your previously configured Metabase Installation back. If it's n
### Adding external dependencies or plugins
-To add external dependency JAR files, such as the Oracle or Vertica JDBC drivers or 3rd-party Metabase drivers), you'll need to:
+To add external dependency JAR files, such as the Oracle or Vertica JDBC drivers or 3rd-party Metabase drivers, you'll need to:
- create a `plugins` directory in your host system, and
- bind that directory so it's available to Metabase as the path `/plugins` (using either `--mount` or `-v`/`--volume`).
diff --git a/docs/installation-and-operation/serialization.md b/docs/installation-and-operation/serialization.md
index e3281b9c351..0d1940875e7 100644
--- a/docs/installation-and-operation/serialization.md
+++ b/docs/installation-and-operation/serialization.md
@@ -47,7 +47,7 @@ Check out our guides for:
Metabase will only export the following entities:
-- Collections (but personal collections don't get exported unless explicitly specified them through [export options](#customize-what-gets-exported))
+- Collections (but personal collections don't get exported unless you explicitly specify them through [export options](#customize-what-gets-exported))
- Dashboards
- Saved questions
- Transforms (including jobs)
@@ -78,11 +78,11 @@ Metabase will export its artifacts to a directory of YAML files. The export incl
- timelines
- databases
- When serializing through the API, the export directory [will be a compressed into a .tar.gz file](#you-must-compress-your-files-when-serializing-via-api-calls).
+ When serializing through the API, the export directory [will be compressed into a .tar.gz file](#you-must-compress-your-files-when-serializing-via-api-calls).
- A `settings.yaml` file that includes some [Metabase-wide settings](#general-metabase-settings-that-are-exported)
-Database connection details are not included by default, so you but you can [configure your export](#customize-what-gets-exported) to include them.
+Database connection details are not included by default, but you can [configure your export](#customize-what-gets-exported) to include them.
### General Metabase settings that are exported
@@ -341,7 +341,7 @@ It refers to the `CATEGORY` field in the `PRODUCTS` table in the `PUBLIC` schema
## How import works
-During import, Metabase will read the provided YAML files and create items according to the YAML specs. [Example of a serialized question](#example-of-a-serialized-question) how Metabase records information it needs to reconstruct an item.
+During import, Metabase will read the provided YAML files and create items according to the YAML specs. See [Example of a serialized question](#example-of-a-serialized-question) for how Metabase records information it needs to reconstruct an item.
Metabase will not delete items from target instance during import, but it will overwrite items that already exist.
diff --git a/docs/installation-and-operation/upgrading-metabase.md b/docs/installation-and-operation/upgrading-metabase.md
index a580294929d..93f0e56d08a 100644
--- a/docs/installation-and-operation/upgrading-metabase.md
+++ b/docs/installation-and-operation/upgrading-metabase.md
@@ -35,7 +35,7 @@ See our [upgrade guide for the modular embedding SDK](../embedding/sdk/upgrade.m
Here are the steps for upgrading to a new Metabase version (major or minor):
-### 1. Back up of your application database
+### 1. Back up your application database
The application database keeps track of every single thing (but the data of your connected database) of your Metabase instance. While it's unlikely you'll need to roll back to your current version, a backup will do wonders for your peace of mind in case something goes wrong.
@@ -185,4 +185,4 @@ If you're running Metabase in a cluster:
2. Perform the upgrade as normal (as outlined above).
3. Raise the number of nodes to the same number you had before.
-Make sure you container orchestrator or cluster manager doesn't kill the Metabase process while it's performing the migrations, otherwise you'll may end up with a corrupted application database and you'll need to restore from a backup.
+Make sure your container orchestrator or cluster manager doesn't kill the Metabase process while it's performing the migrations, otherwise you may end up with a corrupted application database and you'll need to restore from a backup.
diff --git a/docs/people-and-groups/authenticating-with-saml.md b/docs/people-and-groups/authenticating-with-saml.md
index a89ddf55748..c00925de4a8 100644
--- a/docs/people-and-groups/authenticating-with-saml.md
+++ b/docs/people-and-groups/authenticating-with-saml.md
@@ -140,7 +140,7 @@ Note that your certificate text may include header and footer comments that look
### Settings for signing SSO requests (optional)
-To sign request so that they can't be tampered with, you'll need to provide additional settings.
+To sign requests so that they can't be tampered with, you'll need to provide additional settings.
If your IdP encrypts SAML responses, you'll need to ensure this section is filled out.
diff --git a/docs/people-and-groups/user-provisioning.md b/docs/people-and-groups/user-provisioning.md
index af0227cc9ff..5672ab2c324 100644
--- a/docs/people-and-groups/user-provisioning.md
+++ b/docs/people-and-groups/user-provisioning.md
@@ -30,7 +30,7 @@ Metabase will tell you the SCIM endpoint URL and SCIM token to share with your i
## SCIM endpoint URL
-The SCIM endpoint is `/api/ee/scim/v2`. So your URL will looks something like:
+The SCIM endpoint is `/api/ee/scim/v2`. So your URL will look something like:
```
https://metabase.example.com/api/ee/scim/v2
diff --git a/docs/permissions/application.md b/docs/permissions/application.md
index c8ac5a21a16..cb323534ca8 100644
--- a/docs/permissions/application.md
+++ b/docs/permissions/application.md
@@ -11,7 +11,7 @@ redirect_from:
Application settings are useful for granting groups access to some, but not all, of Metabase's administrative features.
-To set application permissions, got to the top right of the screen and click the **grid** icon > **Admin** > **Permissions** > **Application**.
+To set application permissions, go to the top right of the screen and click the **grid** icon > **Admin** > **Permissions** > **Application**.
## Settings access
diff --git a/docs/permissions/collections.md b/docs/permissions/collections.md
index 3933af4ea2c..0aedb05e892 100644
--- a/docs/permissions/collections.md
+++ b/docs/permissions/collections.md
@@ -84,7 +84,7 @@ People in groups with Curate access to a collection can pin items in the collect
To pin an item, select the **pin icon** next to the item's name.
-Note that collections themselves can't be pinned. If you're running on a [Pro or Enterprise plan](https://www.metabase.com/pricing/), admins can designate [Official Collections][offical-collections].
+Note that collections themselves can't be pinned. If you're running on a [Pro or Enterprise plan](https://www.metabase.com/pricing/), admins can designate [Official Collections][official-collections].
## Special collections
@@ -119,7 +119,7 @@ See [Tenants > External collections](../embedding/tenants.md#collection-types)
[collections]: ../exploration-and-organization/collections.md
[collection-permissions]: https://www.metabase.com/learn/metabase-basics/administration/permissions/collection-permissions
[dashboard-subscriptions]: ../dashboards/subscriptions.md
-[offical-collections]: ../exploration-and-organization/collections.md#official-collections
+[official-collections]: ../exploration-and-organization/collections.md#official-collections
[permissions]: https://www.metabase.com/learn/metabase-basics/administration/permissions
[slack-integration]: ../configuring-metabase/slack.md
[sql-snippet-folders]: ../questions/native-editor/snippets.md
diff --git a/docs/permissions/data.md b/docs/permissions/data.md
index 72900291d81..bba543ca6ca 100644
--- a/docs/permissions/data.md
+++ b/docs/permissions/data.md
@@ -192,7 +192,7 @@ See [Upload permissions](../databases/uploads.md#add-people-to-a-group-with-data
Transform permissions control who can manage and run [transforms](../data-studio/transforms/transforms-overview.md) on a database. Transform permissions can only be set on a database level, not on a table level.
-A group can only have transform permissions for a database if they also have "View data" and "Query builder and native" per for _all_ the tables in a database.
+A group can only have transform permissions for a database if they also have "View data" and "Query builder and native" permissions for _all_ the tables in a database.
## Further reading
diff --git a/docs/permissions/database-routing.md b/docs/permissions/database-routing.md
index 5302851676b..306ffd45a6d 100644
--- a/docs/permissions/database-routing.md
+++ b/docs/permissions/database-routing.md
@@ -30,7 +30,7 @@ Database routing is **not supported** on:
- Spark SQL
- Vertica.
-Different database have different setups, so _what_ you can route between (database, schema, data catalog, etc.) will differ slightly depending on which data warehouse you're using.
+Different databases have different setups, so _what_ you can route between (database, schema, data catalog, etc.) will differ slightly depending on which data warehouse you're using.
- Athena: Only routing between different connections is supported (e.g., different buckets, roles, or catalogs).
- BigQuery: Only routing between databases in different projects is supported.
diff --git a/docs/permissions/impersonation.md b/docs/permissions/impersonation.md
index 1d5aff46e45..f0b9c7d3967 100644
--- a/docs/permissions/impersonation.md
+++ b/docs/permissions/impersonation.md
@@ -13,6 +13,7 @@ This page covers the [View data](./data.md#view-data-permissions) permission lev
## Databases that support impersonation
For now, impersonation access is only available for the following databases:
+
- ClickHouse
- MySQL
- PostgreSQL. If you're using views in PostgreSQL, the row-level security policies on views will only work on Postgres versions 15 and higher.
@@ -59,7 +60,7 @@ You can then create roles in the database that have more restrictive access to t
In your database (not in Metabase):
1. Create a new database role (in Redshift, this would be a new user).
-2. Grant that role privileges that you'd like impersonated users to have..
+2. Grant that role privileges that you'd like impersonated users to have.
For exactly how to create a new role in your database and grant that role privileges, you'll need to consult your database's documentation. We also have some docs on [users, roles, and privileges](../databases/users-roles-privileges.md) that can help you get started.
@@ -138,7 +139,7 @@ Remember to also set up ["Create queries"](./data.md#create-queries-permissions)
### Verify that impersonated permissions are working
-Admins will not be able to verify that impersonation is are working from their own account, so you should create a test user, add them to the group and set up their user attributes.
+Admins will not be able to verify that impersonation is working from their own account, so you should create a test user, add them to the group and set up their user attributes.
To verify that the impersonated permissions are working:
@@ -152,7 +153,7 @@ SELECT * FROM people;
to verify that the test user only sees data from Vermont.
-- If the test user has "Create queries" permissions set to "Query builder only", go to **Browse data** in the left sidebar and verify that the user can only see the tables they have access to, and only the data in those tables that
+- If the test user has "Create queries" permissions set to "Query builder only", go to **Browse data** in the left sidebar and verify that the user can only see the tables and data they have access to.
## People in a group with impersonation access to data do not necessarily share the same privileges
@@ -177,7 +178,7 @@ Blue group's more permissive access would override the impersonated access.
## Admins won't see the effects of impersonation
-Admins won't ever see the effects of impersonation effects, because their privileges will override those of any other group they're a member of.
+Admins won't ever see the effects of impersonation, because their privileges will override those of any other group they're a member of.
Metabase's default Administrators group has "Can view" access to all databases, and Metabase uses the most permissive access for any person in multiple groups, so any admin will have "Can view" - not "Impersonated" - access to the database.
diff --git a/docs/permissions/row-and-column-security.md b/docs/permissions/row-and-column-security.md
index cc75a2933e0..54afd8dbb16 100644
--- a/docs/permissions/row-and-column-security.md
+++ b/docs/permissions/row-and-column-security.md
@@ -93,7 +93,7 @@ Examples of user attributes in play:
1. Make sure to do the [prerequisites for row security](#prerequisites-for-row-security) first.
2. Go to **Admin** > **Permissions**.
3. Select the database and table that you want to secure.
-4. Find the group that you want to put in the secure.
+4. Find the group that you want to secure.
5. Click on the dropdown under **View data** for that group.
6. Select "Row and column security".
7. Click the dropdown under **Column** and enter the column to filter the table on, such as "Plan".
@@ -254,7 +254,7 @@ If you put Vincent Accountman in both groups, he'll have conflicting permissions
To resolve row and column security permissions conflicts:
- Remove the person from all but one of the groups.
-- Set the all but one of the group's [View data](./data.md#view-data-permissions) access to the datatabase to "Blocked".
+- Set all but one of the group's [View data](./data.md#view-data-permissions) access to the database to "Blocked".
### You cannot secure the rows or columns of SQL results
@@ -287,7 +287,7 @@ Some things to keep in mind when using row and column security.
### Groups with native query permissions (access to the SQL editor) can bypass row and column security
Row and column security is limited to the [query builder](../questions/query-builder/editor.md).
-You can't set up [native query persmissons](./data.md#create-queries-permissions) for groups with row and column security.
+You can't set up [native query permissions](./data.md#create-queries-permissions) for groups with row and column security.
To enforce row-level permissions with the native query editor, check out [impersonation](./impersonation.md).
diff --git a/docs/questions/introduction.md b/docs/questions/introduction.md
index e34880b4047..b61bee722a8 100644
--- a/docs/questions/introduction.md
+++ b/docs/questions/introduction.md
@@ -15,10 +15,10 @@ Questions in Metabase are queries, their results, and their visualization. Quest
You can create a new question from scratch, or build off of an existing question. To create a question from scratch click on **+ New** and select how you want to query your data:
-- **+ New > Question** to create a question using the graphicalcquery builder. See [Query builder](../questions/query-builder/editor.md).
+- **+ New > Question** to create a question using the graphical query builder. See [Query builder](../questions/query-builder/editor.md).
![Query builder editor](./images/editor.png)
-- **+ New >SQl/Native query** to create a question using the native/SQL query editor. See [Native editor](../questions/native-editor/writing-sql.md).
+- **+ New > SQL/Native query** to create a question using the native/SQL query editor. See [Native editor](../questions/native-editor/writing-sql.md).
![Native editor](./images/native-editor.png)
@@ -31,7 +31,7 @@ Once you've built your query and [visualized its results](./visualizations/visua
### Saving questions to dashboards
-Questions that live in a dashboard are only visible in that dashboard. These questions can't be used in other dashboards. When you save a question to a dashboard, you'll need to arrange the card on one of the dashboard's tab, then save the dashboard.
+Questions that live in a dashboard are only visible in that dashboard. These questions can't be used in other dashboards. When you save a question to a dashboard, you'll need to arrange the card on one of the dashboard's tabs, then save the dashboard.
### Saving questions to collections
diff --git a/docs/questions/native-editor/snippets.md b/docs/questions/native-editor/snippets.md
index b1613077520..ee86b544fa7 100644
--- a/docs/questions/native-editor/snippets.md
+++ b/docs/questions/native-editor/snippets.md
@@ -65,7 +65,7 @@ To add a snippet to your native code, start typing `{% raw %}{{snippet: }}{% end
Metabase is sensitive to whitespace in snippet references, so you should type `{% raw %}{{snippet: Products}}{% endraw %}`, with no space between `{% raw %}{{{% endraw %}` and `snippet`, and with a space between `:` and snippet's name.
-When you execute the query, behind the scenes Metabase replace the snippet reference with the snippet's SQL.
+When you execute the query, behind the scenes Metabase replaces the snippet reference with the snippet's SQL.
You can also just pick a snippet to insert from the snippet sidebar:
diff --git a/docs/questions/query-builder/editor.md b/docs/questions/query-builder/editor.md
index a6835685bbc..9e685ac8e25 100644
--- a/docs/questions/query-builder/editor.md
+++ b/docs/questions/query-builder/editor.md
@@ -31,7 +31,7 @@ To the right of each step in the query builder is a **Preview** button (looks li
## Pick data
-To start building a question with the query builder, you need to select the data you want to work with. You can pick pick a a table from a database, a[model](../../data-modeling/models.md), a [metric](../../data-modeling/metrics.md), or another saved question. You can search by typing, or browse your databases and collections.
+To start building a question with the query builder, you need to select the data you want to work with. You can pick a table from a database, a [model](../../data-modeling/models.md), a [metric](../../data-modeling/metrics.md), or another saved question. You can search by typing, or browse your databases and collections.
![data picker](../images/data-picker.png)
@@ -75,7 +75,7 @@ You can add filters to restrict the data you retrieve. For example, you can tell
![Summary](../images/summarize.png)
-Once you pick the data to query and hhe filters to apply, you can choose to summarize your data - for example, compute the count of rows or average of a column. You can also break out and group summaries by dimensions.
+Once you pick the data to query and the filters to apply, you can choose to summarize your data - for example, compute the count of rows or average of a column. You can also break out and group summaries by dimensions.
See [Summarizing and grouping](./summarizing-and-grouping.md).
@@ -89,7 +89,7 @@ For example, you could do `Average(sqrt[FieldX]) + Sum([FieldY])` or `Max(floor(
The sorting step lets you pick one or more columns to sort your results by. For each column you pick, you can also choose whether to sort ascending or descending; just click the arrow to change from ascending (up arrow) to descending (down arrow).
-If you're using cumulative aggregation functions in you **Summarize** block, the sort order might affect how the aggregation is computed (as opposed to just how the results are displayed ). See [Cumulative functions](../query-builder/expressions/cumulative.md).
+If you're using cumulative aggregation functions in your **Summarize** block, the sort order might affect how the aggregation is computed (as opposed to just how the results are displayed ). See [Cumulative functions](../query-builder/expressions/cumulative.md).
## Setting a row limit
diff --git a/docs/questions/visualizations/funnel.md b/docs/questions/visualizations/funnel.md
index 7fdc104972c..283d6fdc0dc 100644
--- a/docs/questions/visualizations/funnel.md
+++ b/docs/questions/visualizations/funnel.md
@@ -15,7 +15,7 @@ Funnels are commonly used in e-commerce or sales to visualize how many customers
## Data shape for a funnel chart
-To create a funnel in Metabase, you'll need to have a table with at least two columns: one column that contains the funnel's steps, and another column contains the metric you're interested in, like the number of customers at this step.
+To create a funnel in Metabase, you'll need to have a table with at least two columns: one column that contains the funnel's steps, and another column that contains the metric you're interested in, like the number of customers at this step.
Here's the data shape used to create the chart above:
diff --git a/docs/questions/visualizations/line-bar-and-area-charts.md b/docs/questions/visualizations/line-bar-and-area-charts.md
index b8de697d727..7f7975d769d 100644
--- a/docs/questions/visualizations/line-bar-and-area-charts.md
+++ b/docs/questions/visualizations/line-bar-and-area-charts.md
@@ -68,7 +68,7 @@ For each series on the chart, you can:
- Line shape
- Line style
- Line size: Small, Medium, or Large
-- Whether to show docs on the lines (the dots represent the actual data points plotted on the chart)
+- Whether to show dots on the lines (the dots represent the actual data points plotted on the chart)
- Whether to show values for the series. This option is only available if you've toggled on [Show value on data points](#values-on-data-points).
- How to replace missing values: Zero, Nothing (just a break in the line), or Linear interpolated
diff --git a/docs/questions/visualizations/map.md b/docs/questions/visualizations/map.md
index cd2e32b818a..592b1997543 100644
--- a/docs/questions/visualizations/map.md
+++ b/docs/questions/visualizations/map.md
@@ -93,7 +93,7 @@ To create a grid map:
Region maps display a distribution of aggregated data broken out by regions, like count of users by country.
-Metabase comes with two built-in regions: [world map](#world-map) with countries, and the [Unites States map](#united-states-map) with states. Admins can [add custom regions](#custom-regions) in Admin setting.
+Metabase comes with two built-in regions: [world map](#world-map) with countries, and the [United States map](#united-states-map) with states. Admins can [add custom regions](#custom-regions) in Admin settings.
![Three types of region maps](../images/region-maps.png)
diff --git a/docs/questions/visualizations/pivot-table.md b/docs/questions/visualizations/pivot-table.md
index 8af3cca10d5..99fd025b261 100644
--- a/docs/questions/visualizations/pivot-table.md
+++ b/docs/questions/visualizations/pivot-table.md
@@ -24,7 +24,7 @@ A pivot table is a table that has dimensions in both rows and columns, and metri
The reason they're called pivot tables is because you can rotate ("pivot") a column 90 degrees so that the values in that column become column headings themselves. Pivoting values into column headings is useful when analyzing data across multiple attributes, like time, location, and category. You can pivot multiple rows to columns and vice versa, or not pivot any at all.
-Pivot table is the only Metabase visualization type (besides the plain table, of course) can display several metrics simultaneously along several dimensions.
+Pivot table is the only Metabase visualization type (besides the plain table, of course) that can display several metrics simultaneously along several dimensions.
## How to create a pivot table
diff --git a/docs/questions/visualizations/visualizing-results.md b/docs/questions/visualizations/visualizing-results.md
index 3f5abb15d52..6fc348f26fd 100644
--- a/docs/questions/visualizations/visualizing-results.md
+++ b/docs/questions/visualizations/visualizing-results.md
@@ -12,7 +12,7 @@ While tables are useful for looking up information or finding specific numbers,
## Visualize query results
-The query builder will automatically select an appropriate chart to visual your results. With native queries, however, you'll need to manually select a chart type.
+The query builder will automatically select an appropriate chart to visualize your results. With native queries, however, you'll need to manually select a chart type.
### Visualizing questions in the query builder
diff --git a/docs/troubleshooting-guide/cant-send-email.md b/docs/troubleshooting-guide/cant-send-email.md
index da69f84e73d..0ed6b402dee 100644
--- a/docs/troubleshooting-guide/cant-send-email.md
+++ b/docs/troubleshooting-guide/cant-send-email.md
@@ -18,7 +18,7 @@ Before any other troubleshooting, try sending a test email to isolate the proble
1. Navigate to the **Admin Panel** and click **Email** in the left sidebar.
2. Confirm that your host, port, email address, and password are entered correctly. If they are, click **Save changes**. If your changes have successfully saved, you'll see an option to **Send test email**.
-3. Click **Send test email**. The test email will go the address associated with your Metabase account.
+3. Click **Send test email**. The test email will go to the address associated with your Metabase account.
4. Verify that the email is delivered to your account.
5. If the message is not sent or an error message is displayed in Metabase, try to use the same account credentials in another email program and see if they work. See the logs for more detailed error by navigating to **Tools** and click **Logs** in the left sidebar.
diff --git a/docs/troubleshooting-guide/data-permissions.md b/docs/troubleshooting-guide/data-permissions.md
index 39ea81845bc..575c1635fc3 100644
--- a/docs/troubleshooting-guide/data-permissions.md
+++ b/docs/troubleshooting-guide/data-permissions.md
@@ -27,7 +27,7 @@ If a person has the wrong level of access to the data that's returned by a quest
1. Ensure scripts are loading by disabling browser extensions and refreshing the browser.
2. Go to **Admin** > **Permissions** and select the relevant group.
3. Find the database that you want to grant SQL access to.
-4. From the **View data** dropdown.elect **Can view**.
+4. From the **View data** dropdown, select **Can view**.
5. From the **Create queries** dropdown, select **Query builder and native**.
6. [Check if the access problem is fixed](#checking-someones-access-to-a-table-or-schema).
diff --git a/docs/troubleshooting-guide/row-and-column-security.md b/docs/troubleshooting-guide/row-and-column-security.md
index 9fe214d19ce..7c8e58a0259 100644
--- a/docs/troubleshooting-guide/row-and-column-security.md
+++ b/docs/troubleshooting-guide/row-and-column-security.md
@@ -117,7 +117,7 @@ Add these people to a group (or create a new group) that has permissions to view
### Has an administrator hidden fields in the table?
-**Root cause:**: An administrator has hidden fields in the table.
+**Root cause**: An administrator has hidden fields in the table.
**Steps to take:**