Skip to content

Commit f828dd2

Browse files
github-automation-metabaseMetabase Docs bot
andauthored
[auto] adding content to master->master (#752)
Co-authored-by: Metabase Docs bot <[email protected]>
1 parent 8e4ca4f commit f828dd2

File tree

291 files changed

+8358
-1447
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

291 files changed

+8358
-1447
lines changed

_docs/master/documents/introduction.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ To edit a chart, click the **three-dot** menu in the chart's upper right. You ca
5858
- Edit visualization
5959
- Edit query
6060
- Replace the chart with another question or model
61+
- [Download results](../questions/exporting-results#exporting-results-from-document-cards)
6162

6263
Edits only affect the chart in the document. If you added the chart from a collection, Metabase will have created a copy of the chart. Any changes made to the chart in the document won't affect the original question.
6364

@@ -130,6 +131,10 @@ This deletion is permanent.
130131

131132
To print a document, click on the **three-dot** menu and select **Print document**.
132133

134+
## Sharing documents
135+
136+
Admins can create [public links](../embedding/public-links#create-a-public-link-for-a-document) to share documents with anyone.
137+
133138
## When to use a document vs. a dashboard
134139

135140
Documents and dashboards both have their use cases.

_docs/master/embedding/public-links.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ redirect_from:
1616

1717
> Only admins can create public links and iframes.
1818
19-
Admins can create and share public links (URLs) for questions and dashboards. People can view them as standalone destinations (URLs) or as embedded iframes in another page or app. In both cases, the public item will display static (view-only) results of your question or dashboard, so visitors won't be able to drill down into the underlying data on their own.
19+
Admins can create and share public links (URLs) for questions, dashboards, and documents. People can view them as standalone destinations (URLs) or as embedded iframes in another page or app. Public items display view-only results of your question, dashboard, or document, so visitors won't be able to drill down into the underlying data on their own.
2020

2121
## Create a public link for a question
2222

@@ -46,6 +46,12 @@ To share a dashboard via a public link, admins can click on the **Sharing** butt
4646

4747
To embed a dashboard, see [static embedding](./static-embedding).
4848

49+
## Create a public link for a document
50+
51+
To share a document via a public link, admins can click on the **Sharing** button in the top right menu and select **Create a public link**.
52+
53+
Public documents are read-only: viewers cannot edit the content or add comments. For charts embedded in the document, viewers can download the results in CSV, XLSX, or JSON format using the **Download results** option in the chart menu.
54+
4955
## Exporting raw, unformatted question results
5056

5157
To export the raw, unformatted rows, you'll need to append `?format_rows=false` to the URL Metabase generates. For example, if you create a public link for a CSV download, the URL would look like:
@@ -162,7 +168,7 @@ To disable public sharing:
162168
3. In the **Settings** tab, select **Public sharing**.
163169
4. Toggle off **Public sharing**.
164170

165-
Once toggled on, the **Public sharing** section will display Metabase questions, dashboards, and actions with active public links.
171+
Once toggled on, the **Public sharing** section will display Metabase questions, dashboards, documents, and actions with active public links.
166172

167173
If you disable public sharing, then re-enable public sharing, all your previously generated public links will still work (as long as you didn't deactivate them).
168174

@@ -187,7 +193,7 @@ Admins can view and deactivate all public links for a Metabase.
187193

188194
## See all publicly shared content
189195

190-
Admins can see all publicly shared questions, dashboards, and actions in **Admin Settings > Public Sharing**.
196+
Admins can see all publicly shared questions, dashboards, documents, and actions in **Admin Settings > Public Sharing**.
191197

192198
![See shared content](./images/see-shared-content.png)
193199

_docs/master/questions/exporting-results.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,21 @@ By default, Metabase will export first 1048575 rows of results.
7777

7878
When exporting results to an Excel document (.xlsx), Metabase will limit the number of characters per cell to 32,767, which is the [character limit enforced by Excel](https://support.microsoft.com/en-us/office/excel-specifications-and-limit-1672b34d-7043-467e-8e27-269d656771c3). If you have a bonkers number of characters in a single cell, Metabase will truncate the content to fit within that limit.
7979

80+
## Exporting results from document cards
81+
82+
You can download results from charts embedded in [documents](../documents/introduction).
83+
84+
To export results from a chart in a document:
85+
86+
1. Hover over the chart in the document.
87+
2. Click on the three dot menu (**...**).
88+
3. Select **Download results**.
89+
4. Choose your format: .csv, .xlsx, or .json.
90+
91+
You can export results as formatted or unformatted (hold `Option` on Mac or `Alt` on Windows when clicking the format).
92+
93+
If you don't see the **Download results** option, you may not have [permissions to download results](../permissions/data#download-results-permissions).
94+
8095
## Exporting data via a public link
8196

8297
You can create a [public link](../embedding/public-links#public-link-to-export-question-results-in-csv-xlsx-json) that people can use to download data in a specific format, as well as [raw, unformatted question results](../embedding/public-links#exporting-raw-unformatted-question-results).

_docs/master/troubleshooting-guide/row-and-column-security.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,5 @@ The administrator can [create a new group][groups] to capture precisely who's al
184184
[row-permissions]: /learn/metabase-basics/administration/permissions/data-sandboxing-row-permissions
185185
[row-and-column-security]: ../permissions/row-and-column-security
186186
[static-embedding]: /learn/metabase-basics/embedding/charts-and-dashboards#enable-embedding-in-other-applications
187-
[row-and-column-security-limitations]: ../permissions/row-and-column-security#limitations
188187
[troubleshooting-permissions]: ./permissions
189-
[unsupported-databases]: ../permissions/row-and-column-security#limitations
188+
[unsupported-databases]: ../permissions/row-and-column-security#limitations-of-row-and-column-security

_site/docs/all.html

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -173,8 +173,15 @@
173173

174174

175175

176-
<header class="bootstrap sticky">
177-
<div class="navigation-header bg-neutral-white ">
176+
177+
178+
179+
180+
181+
182+
183+
<header class="bootstrap sticky">
184+
<div class="navigation-header bg-neutral-white bg-neutral-white">
178185

179186
<div class="promo-banner hidden">
180187
<div>
@@ -192,11 +199,13 @@
192199

193200

194201

195-
<div class="container d-flex h-100 align-items-center">
202+
<div class="container">
196203
<div class="row flex-grow-1">
197-
<div class="col-xs-4 col-lg-2 d-flex align-items-center">
204+
<div class="home-link col-xs-4 col-lg-2 d-flex align-items-center">
198205
<a href="/">
199-
<div class="MB-Logo inline-block"></div>
206+
207+
<div class="MB-Logo inline-block"></div>
208+
200209
</a>
201210
</div>
202211

_site/docs/master/CONTRIBUTING.html

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -175,8 +175,15 @@
175175

176176

177177

178-
<header class="bootstrap sticky">
179-
<div class="navigation-header bg-neutral-white ">
178+
179+
180+
181+
182+
183+
184+
185+
<header class="bootstrap sticky">
186+
<div class="navigation-header bg-neutral-white bg-neutral-white">
180187

181188
<div class="promo-banner hidden">
182189
<div>
@@ -194,11 +201,13 @@
194201

195202

196203

197-
<div class="container d-flex h-100 align-items-center">
204+
<div class="container">
198205
<div class="row flex-grow-1">
199-
<div class="col-xs-4 col-lg-2 d-flex align-items-center">
206+
<div class="home-link col-xs-4 col-lg-2 d-flex align-items-center">
200207
<a href="/">
201-
<div class="MB-Logo inline-block"></div>
208+
209+
<div class="MB-Logo inline-block"></div>
210+
202211
</a>
203212
</div>
204213

@@ -3885,6 +3894,21 @@ <h5>Administration</h5>
38853894

38863895

38873896

3897+
<li class="">
3898+
<a href="/docs/master/installation-and-operation/remote-sync" class="">
3899+
Remote Sync
3900+
3901+
3902+
</a>
3903+
3904+
</li>
3905+
3906+
3907+
3908+
3909+
3910+
3911+
38883912
<li class="">
38893913
<a href="/docs/master/installation-and-operation/commands" class="">
38903914
Commands

_site/docs/master/actions/basic.html

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -175,8 +175,15 @@
175175

176176

177177

178-
<header class="bootstrap sticky">
179-
<div class="navigation-header bg-neutral-white ">
178+
179+
180+
181+
182+
183+
184+
185+
<header class="bootstrap sticky">
186+
<div class="navigation-header bg-neutral-white bg-neutral-white">
180187

181188
<div class="promo-banner hidden">
182189
<div>
@@ -194,11 +201,13 @@
194201

195202

196203

197-
<div class="container d-flex h-100 align-items-center">
204+
<div class="container">
198205
<div class="row flex-grow-1">
199-
<div class="col-xs-4 col-lg-2 d-flex align-items-center">
206+
<div class="home-link col-xs-4 col-lg-2 d-flex align-items-center">
200207
<a href="/">
201-
<div class="MB-Logo inline-block"></div>
208+
209+
<div class="MB-Logo inline-block"></div>
210+
202211
</a>
203212
</div>
204213

@@ -3885,6 +3894,21 @@ <h5>Administration</h5>
38853894

38863895

38873896

3897+
<li class="">
3898+
<a href="/docs/master/installation-and-operation/remote-sync" class="">
3899+
Remote Sync
3900+
3901+
3902+
</a>
3903+
3904+
</li>
3905+
3906+
3907+
3908+
3909+
3910+
3911+
38883912
<li class="">
38893913
<a href="/docs/master/installation-and-operation/commands" class="">
38903914
Commands

_site/docs/master/actions/custom.html

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -175,8 +175,15 @@
175175

176176

177177

178-
<header class="bootstrap sticky">
179-
<div class="navigation-header bg-neutral-white ">
178+
179+
180+
181+
182+
183+
184+
185+
<header class="bootstrap sticky">
186+
<div class="navigation-header bg-neutral-white bg-neutral-white">
180187

181188
<div class="promo-banner hidden">
182189
<div>
@@ -194,11 +201,13 @@
194201

195202

196203

197-
<div class="container d-flex h-100 align-items-center">
204+
<div class="container">
198205
<div class="row flex-grow-1">
199-
<div class="col-xs-4 col-lg-2 d-flex align-items-center">
206+
<div class="home-link col-xs-4 col-lg-2 d-flex align-items-center">
200207
<a href="/">
201-
<div class="MB-Logo inline-block"></div>
208+
209+
<div class="MB-Logo inline-block"></div>
210+
202211
</a>
203212
</div>
204213

@@ -3885,6 +3894,21 @@ <h5>Administration</h5>
38853894

38863895

38873896

3897+
<li class="">
3898+
<a href="/docs/master/installation-and-operation/remote-sync" class="">
3899+
Remote Sync
3900+
3901+
3902+
</a>
3903+
3904+
</li>
3905+
3906+
3907+
3908+
3909+
3910+
3911+
38883912
<li class="">
38893913
<a href="/docs/master/installation-and-operation/commands" class="">
38903914
Commands

_site/docs/master/actions/introduction.html

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -175,8 +175,15 @@
175175

176176

177177

178-
<header class="bootstrap sticky">
179-
<div class="navigation-header bg-neutral-white ">
178+
179+
180+
181+
182+
183+
184+
185+
<header class="bootstrap sticky">
186+
<div class="navigation-header bg-neutral-white bg-neutral-white">
180187

181188
<div class="promo-banner hidden">
182189
<div>
@@ -194,11 +201,13 @@
194201

195202

196203

197-
<div class="container d-flex h-100 align-items-center">
204+
<div class="container">
198205
<div class="row flex-grow-1">
199-
<div class="col-xs-4 col-lg-2 d-flex align-items-center">
206+
<div class="home-link col-xs-4 col-lg-2 d-flex align-items-center">
200207
<a href="/">
201-
<div class="MB-Logo inline-block"></div>
208+
209+
<div class="MB-Logo inline-block"></div>
210+
202211
</a>
203212
</div>
204213

@@ -3885,6 +3894,21 @@ <h5>Administration</h5>
38853894

38863895

38873896

3897+
<li class="">
3898+
<a href="/docs/master/installation-and-operation/remote-sync" class="">
3899+
Remote Sync
3900+
3901+
3902+
</a>
3903+
3904+
</li>
3905+
3906+
3907+
3908+
3909+
3910+
3911+
38883912
<li class="">
38893913
<a href="/docs/master/installation-and-operation/commands" class="">
38903914
Commands

0 commit comments

Comments
 (0)