Skip to content

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

docs - upload edits (#71684)

Jeff Bruemmer7034d54542ac
diff --git a/docs/cloud/google-sheets.md b/docs/cloud/google-sheets.md
index d48d81770d1..150f3edb3ee 100644
--- a/docs/cloud/google-sheets.md
+++ b/docs/cloud/google-sheets.md
@@ -27,7 +27,7 @@ An admin can set up Metabase to sync with either:
Here's how to set it up:
-1. In the left nav sidebar, click **Add Data** > **Connect Google Sheets**.
+1. In the left nav sidebar, click the **+** next to **Data**, then select **Google Sheets**.
2. Select **Entire Folder** or **Single sheet**.
3. Metabase will ask you to share the Google Drive folder or sheet. You can only share a single folder or sheet with Metabase at a time.
4. In Google Drive, share the folder or sheet with the service account that Metabase provides.
diff --git a/docs/cloud/images/connect-google-sheets.png b/docs/cloud/images/connect-google-sheets.png
index 7c0923f4bc3..ee53a42a813 100644
Binary files a/docs/cloud/images/connect-google-sheets.png and b/docs/cloud/images/connect-google-sheets.png differ
diff --git a/docs/databases/uploads.md b/docs/databases/uploads.md
index b05f0ae4c6b..3a60077d873 100644
--- a/docs/databases/uploads.md
+++ b/docs/databases/uploads.md
@@ -1,5 +1,6 @@
---
title: Setting up data uploads
+description: How admins can enable CSV uploads by connecting a database with write access, selecting an upload schema, and granting people data and collection permissions.
---
# Setting up data uploads
@@ -61,6 +62,8 @@ Admins can optionally specify a string of text to add in front of the table that
In order to upload CSVs, a person must be in a group with **View data** access of "Can view" and **Create queries** of Query builder access or higher to the schema you've selected to store your uploaded data. See [groups](../people-and-groups/managing.md) and [data permissions](../permissions/data.md).
+People also need [Curate access](../permissions/collections.md#curate-access) to any collection they want to upload to. The upload icon only appears in collections where they have Curate access. Everyone has Curate access to their [personal collection](../permissions/collections.md#personal-collections) by default.
+
## Note on uploading data to a MySQL database
For speeding up uploads to a MySQL database, we recommend that you set a `local_infile` to `ON`. You'll need to set this `local_infile` in MySQL, not Metabase. The command-line format is `--local-infile=ON`.
diff --git a/docs/exploration-and-organization/uploads.md b/docs/exploration-and-organization/uploads.md
index d89fe8332ed..5d7fe6db00c 100644
--- a/docs/exploration-and-organization/uploads.md
+++ b/docs/exploration-and-organization/uploads.md
@@ -1,18 +1,47 @@
---
title: Uploading data
+description: Upload CSV files to Metabase to create models. Requires uploads enabled by an admin, data permissions on the upload schema, and Curate access to the target collection.
---
# Uploading data
-If an admin has [set up uploads](../databases/uploads.md), you can upload CSV data by clicking on the **Upload** icon in the top right of the collection page.
+You can upload CSV files to Metabase to query, visualize, and share.
+
+## Upload requirements
+
+To upload CSV data, you'll need:
+
+- Uploads [enabled](../databases/uploads.md) by an admin.
+- [Data permissions](../permissions/data.md): your group needs **Can view** data access and **Create queries** access (query builder or higher) for the upload schema. (Unless you're an admin, you can't see what groups you're in; just noting this here so you know groups are a thing. Ask your admin to put you in a group with these privileges).
+- [Curate access](../permissions/collections.md#curate-access) to the collection you want to upload to.
+
+The upload icon only appears in collections where you have Curate access. Everyone has Curate access to their [personal collection](../permissions/collections.md#personal-collections), so you can always upload there.
+
+## Uploading a CSV file
+
+**From a collection page**:
+
+1. Go to the collection where you want to save the uploaded data.
+2. Click the **Upload** icon (the cloud with an arrow) in the upper right of the collection page.
+3. Select your CSV file.
![Upload CSV data](../databases/images/upload-icon.png)
+**From the sidebar**:
+
+1. Click the **Add data** button (**+**) next to **DATA** in the left sidebar.
+2. Select **CSV**.
+3. Drag and drop a file or click **Select a file**.
+4. Choose the destination collection at the bottom of the modal.
+5. Click **Upload**.
+
+You can also add data from [Google Sheets](../cloud/google-sheets.md) (Metabase Cloud only).
+
## Create, append, or replace models with uploads
When you upload a CSV file, Metabase may ask to select a destination for that upload (depending on whether there are other uploads).
-If your CSV has the same columns as a model from a previously uploaded file, you can append data to that model. Otherwise, you can create a new [model](../data-modeling/models.md). if you want to:
+If your CSV has the same columns as a model from a previously uploaded file, you can append data to that model. Otherwise, you can create a new [model](../data-modeling/models.md). You can:
- Create a new model
- [Append to an existing model created by an upload](#appending-to-a-model-created-by-an-upload)
@@ -20,8 +49,6 @@ If your CSV has the same columns as a model from a previously uploaded file, you
Metabase will create a [model](../data-modeling/models.md) that contains that CSV data, as well as the model's underlying table.
-Uploads will only be available if your admin has enabled uploads for your Metabase, and you're in a group with Unrestricted access to the schema used to store those uploads. See [Uploading data](../databases/uploads.md).
-
## Appending to a model created by an upload
You can upload additional CSV data to an existing model created by a previous CSV upload.