# CMS: Adding and Setting Up an Upload Button

Source: https://support.wix.com/en/article/cms-adding-and-setting-up-an-upload-button (updated 2026-11-11)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Create an upload button to allow site visitors to submit files directly to your [CMS (Content Management System)](https://support.wix.com/en/article/cms-content-management-system-an-overview) collections. 

  
 When you connect the upload button to your collection, you choose the type of collection field that will store the uploaded files. You can choose from 'Image', 'Document', 'Video', 'Audio', 'Media gallery', or 'Multi-document' field types. 

  
 The field type you connect also determines the type of file your upload button can accept. The uploaded files are stored as new items in your collection and in the 'Visitor Uploads' section of your media manager.

> **Before you begin:** Make sure to [add the CMS to your editor](https://support.wix.com/en/article/cms-formerly-content-manager-getting-started) if you haven't already.

> **Note:** Input elements aren't available in the Wix Harmony Editor, so visitors can't filter your content or submit items to your collection. To collect information from visitors, add a form with Wix Forms instead. Learn more about [features that work differently in Wix Harmony](https://support.wix.com/en/article/wix-harmony-whats-new-with-the-cms#features-that-work-differently-in-wix-harmony).

---

## Step 1 | Add the upload button element

Go to the relevant page in your editor and add the upload button.

**Wix Editor:**

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Go to the page in which you want to add an upload button.
3. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/65d5031a-8d20-483c-b08f-0a758e1cf2fd/68a0236f-77f4-43c6-931f-8298ae691a9e/2022/11/17/01f24c8b-2ea3-4d06-a26d-9975a43d617e/a79e245b-4870-4444-ba82-248eca4eb9a7.png) on the left side of the editor.
4. Click **Input**.
5. Click **Upload Buttons** under **Advanced**.
6. Click and drag the upload button you want to use onto the page.

![Screenshot of adding an upload button in the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/c132d201-03eb-4d0e-bbb1-b803bcbe0632/1d6c6dd7-dfc2-446a-98cc-e1795d75b9ab.png)

**Studio Editor:**

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Go to the page in which you want to add an upload button.
3. Click **Add Elements** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/06/14/cef22a14-dfc9-43c7-a54f-72ed83266050/741248d2-4240-497e-a282-2a7d15d8afac.png) on the left side of the editor.
4. Click **Input**.
5. Click **Upload Buttons** under **Selections**.
6. Click and drag the upload button you want to use onto the page.

![Screenshot of adding an upload button in the Studio Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/05666d46-ae8f-4c38-947a-04539f86a02b/80ffa4b2-3ae9-4133-8ba7-0b40353e2434.png)

---

## Step 2 | Connect to the CMS through a dataset

Connect your upload button to a [dataset](https://support.wix.com/en/article/cms-about-datasets) that connects to the CMS collection field where you will store the submissions.

**Wix Editor:**

1. In your editor, click the upload button you just added.
2. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) .
3. Click the **Choose a dataset** drop-down and select an existing dataset that connects to the collection you will store submissions in. Alternatively, select **Add a Dataset**, then choose the collection you want to store submissions in.
4. Add a field to your collection where you will store the upload button submissions:  
**Tip:** Alternatively, you can connect to an existing collection field.  
   1. Click the **File connects to** drop-down and select **+ Add**.  
   2. Enter a **Field Name** for the new collection field.  
   3. Select the **Field Type** you want to add to your collection from the drop-down. The field type determines [the kind of files you can store in the field](https://support.wix.com/en/article/cms-formerly-content-manager-supported-content-in-collection-field-types).  
   4. Click **Add**.

![Screenshot of adding a field that connects to the upload button.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/70ae4c31-5e51-4128-b5b1-bc7d08579eea/d458fae3-b62f-4a04-8ddd-41fce4ad7c6c.png)

**Studio Editor:**

1. In your editor, click the upload button you just added.
2. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) .
3. Click the **Choose a dataset** drop-down and select an existing dataset that connects to the collection you will store submissions in. Alternatively, select **Add a Dataset**, then choose the collection you want to store submissions in.
4. Add a field to your collection where you will store the upload button submissions:  
**Tip:** Alternatively, you can connect to an existing collection field.  
   1. Click the **File connects to** drop-down and select **+ Add**.  
   2. Enter a **Field Name** for the new collection field.  
   3. Select the **Field Type** you want to add to your collection from the drop-down. The field type determines [the kind of files you can store in the field](https://support.wix.com/en/article/cms-formerly-content-manager-supported-content-in-collection-field-types).  
   4. Click **Add**.

![Screenshot of adding a collection field to store upload button submissions.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/04227154-b134-45d7-a467-e6573def9dda/cff68184-ea71-49a7-8410-f91dd9d7a938.png)

---

## Step 3 | Set the dataset mode and collection permissions

Datasets control the connection between your upload button and your CMS collection. Make sure to set the dataset mode to **Write** or **Read & Write** so the upload button can add the files to your collection. If needed, adjust the collection permissions to control who can access the collection content.

**Wix Editor:**

1. In the panel on the right, click **Dataset Settings**.

![Screenshot of clicking the dataset settings in the Wix Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/f0700ef7-a3a2-4d67-94b5-6d09a4d88c0e/9a78f047-0fb3-46c0-8842-a18eabd911ba.png)

1. (If necessary) Click the [permission type](https://support.wix.com/en/article/cms-collection-permissions-overview) next to **Permissions** to determine who can view, add, update, or delete collection content.
2. Click the **Dataset mode** drop-down and select the relevant option:  
   * **Write:** Connected [input elements](https://support.wix.com/en/article/cms-about-user-input-elements) can add new items to the collection, but cannot edit existing items.  
   * **Read & Write:** Connected elements can update existing items in the collection. If you connect a ['New' button](https://support.wix.com/en/article/cms-about-dataset-click-actions-for-buttons-and-images#new), visitors can use it to update existing items and add new items to your collection.

![Screenshot of setting the dataset mode.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/11/22/ae2a75eb-8aa9-4507-a4a4-d8883b6fb044/2bf6b309-57ed-47d8-bce6-a4427364b942.png)

**Studio Editor:**

1. In the panel on the right, click **Dataset Settings**.

![Screenshot of clicking the dataset settings.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/dcc6bb48-8614-48e6-8d6f-195b364cae66/2d4527b8-761b-40a4-b25a-2a7c3b6a0609.png)

1. (If necessary) Click the [permission type](https://support.wix.com/en/article/cms-collection-permissions-overview) next to **Permissions** to determine who can view, add, update, or delete collection content.
2. Click the **Dataset mode** drop-down and select the relevant option:  
   * **Write:** Connected [input elements](https://support.wix.com/en/article/cms-about-user-input-elements) can add new items to the collection, but cannot edit existing items.  
   * **Read & Write:** Connected elements can update existing items in the collection. If you connect a ['New' button](https://support.wix.com/en/article/cms-about-dataset-click-actions-for-buttons-and-images#new), visitors can use it to update existing items and add new items to your collection.

![Screenshot of setting the dataset mode.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/11/22/44f776b1-eaea-495c-8f3c-f9fa8a5ee4b1/ace7011e-7665-4287-bafd-bdddb841e339.png)

---

## Step 4 | Customize the upload button

Go to the upload button settings to set the type of file(s) the button accepts and the number of files that can be uploaded at a time. In the layout and design settings you can customize the button's appearance to match your site.

**Wix Editor:**

1. In your editor, click the upload button.
2. Click **Settings** and edit the following:  
   * **Upload settings:** Choose the file types accepted, the max number of files, and whether to set as required:  
         * **Supported file type:** Click the drop-down and choose the type of files the button accepts: **Image & Video**, **Image**, **Video**, **Document**, or **Audio**.  
         * **Max number of files:** Drag the slider to set the limit on how many files can be uploaded per submission. If you want to accept more than one file at a time, make sure you've connected the button to a 'Multi-document' or 'Media Gallery' field type in your collection ([see Step 2](https://support.wix.com/en/article/cms-adding-and-setting-up-an-upload-button?tabs=Wix-Editor-0#step-2-connect-to-the-cms-through-a-dataset)). These are the only field types that can store multiple files per collection item.  
         **Note:** Currently, it is only possible to upload one audio file at a time. You can [vote for the ability to upload more audio files at a time](https://support.wix.com/en/article/cms-request-allowing-visitors-to-upload-multiple-audio-files-at-once-using-the-upload-button) if you would like to see this in the future.  
         * **Required:** Select the checkbox to make it mandatory that visitors upload a file before they can submit your custom form.  
   * **Display options:** Customize the following options:  
         * **Field title:** (Recommended) Enter a title that displays above the button text.  
         * **Button text:** Edit the text that appears on the button itself.  
         * **Text below button:** Choose what you want to display below the button:  
                  * **Show file info only:** Display the name of the file your visitor uploads.  
                  * **Show custom text:** Enter custom text that you want to display below the button such as file requirements. This text changes to the name of the file once it has been uploaded.

![Screenshot of setting the upload button settings.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/5cb466fe-22ca-415e-ab36-c6c576ddb09c/9c1f372f-0826-4b9c-b0da-9f9a96c26c39.png)

1. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2020/09/09/798f1587-1548-45a3-a348-e8e732d7506e/0707c0e8-d8a9-4e1b-9ca8-891fa5d2986b.png) to adjust the spacing, direction, alignment and icon position. Click **Advanced** to set the alignment and direction of specific text.
2. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2020/09/09/1411ec4e-ead8-4e30-8251-184c2870c248/3030d907-3fa3-4bcc-9db2-c2bf03d3ad89.png) and choose a preset button. Click **Customize Design** to further customize the button's design.

**Studio Editor:**

1. In your editor, click the upload button.
2. Click **Settings** and edit the following:  
   * **Upload settings:** Choose the file types accepted, the max number of files, and whether to set as required:  
         * **Supported file type:** Click the drop-down and choose the type of files the button accepts: **Image & Video**, **Image**, **Video**, **Document**, or **Audio**.  
         * **Max number of files:** Drag the slider to set the limit on how many files can be uploaded per submission. If you want to accept more than one file at a time, make sure you've connected the button to a 'Multi-document' or 'Media Gallery' field type in your collection ([see Step 2](https://support.wix.com/en/article/cms-adding-and-setting-up-an-upload-button?tabs=Studio-Editor-1#step-2-connect-to-the-cms-through-a-dataset)). These are the only field types that can store multiple files per collection item.  
         **Note:** Currently, it is only possible to upload one audio file at a time. You can [vote for the ability to upload more audio files at a time](https://support.wix.com/en/article/cms-request-allowing-visitors-to-upload-multiple-audio-files-at-once-using-the-upload-button) if you would like to see this in the future.  
         * **Required:** Select the checkbox to make it mandatory that visitors upload a file before they can submit your custom form.  
   * **Display options:** Customize the following options:  
         * **Field title:** (Recommended) Enter a title that displays above the button text.  
         * **Button text:** Edit the text that appears on the button itself.  
         * **Text below button:** Choose what you want to display below the button:  
                  * **Show file info only:** Display the name of the file your visitor uploads.  
                  * **Show custom text:** Enter custom text that you want to display below the button such as file requirements. This text changes to the name of the file once it has been uploaded.

![Screenshot of the upload button settings in the Studio Editor.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/34350f26-2ea2-48ab-b270-aa02eb094585/7daa2fb8-56a6-4a79-ba47-d798803be695.png)

1. Click the **Layout** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/08/10/0a1a1ce3-e6b1-4379-a6a4-840f722f60ba/0ff0e132-c638-4135-b393-0418e10824a9.png) to adjust the spacing, direction, alignment and icon position. Click **Advanced** to set the alignment and direction of specific text.
2. Click the **Design** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2020/09/09/1411ec4e-ead8-4e30-8251-184c2870c248/3030d907-3fa3-4bcc-9db2-c2bf03d3ad89.png) in the Inspector panel on the right to customize the appearance of the upload button.

---

## Step 5 | Create a submit button

You need to create a way for visitors to submit the files they upload with the button. Add a regular button or image and connect it to the same dataset that connects to your submissions collection. Then set the click action for the button or image to **Submit**. This allows the uploaded files to 'write', or create a new item in the submissions collection upon clicking the submit button. 

  
 If you connect [other input elements](https://support.wix.com/en/article/cms-about-user-input-elements) to the same dataset, the submit button also sends their inputs to the collection.

> Learn how to [create a submit button](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-5-create-a-submit-button) for your upload button.

![Screenshot of a submit button below the upload button.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/25/f748b05f-c2b0-4663-8645-892fdadb4020/a5b2163b-0482-4d7e-83bf-ff312844620f.png)

---

## Frequently Asked Questions (FAQs)

Click below for answers to common questions about the upload button.

**How do I connect to a 'Multi-document' field type?**

1. Select **Document** from the **Supported file type** drop-down in the upload button settings.
2. Drag the **Max number of files** slider to set the limit on how many files can be uploaded per submission.
3. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) on your upload button.
4. Click the **Choose a dataset** drop-down and select an existing dataset that connects to the collection you will store submissions in. Alternatively, select **Add a Dataset**, then choose the collection you want to store submissions in.
5. Add a 'Multi-document' field to your collection where you will store the upload button submissions:  
**Tip:** Alternatively, you can connect to an existing 'Multi-document' collection field.  
   1. Click the **File connects to** drop-down and select **+ Add**.  
   2. Enter a **Field Name** for the new collection field.  
   3. Click the **Field Type** drop-down and select **Multi-Document**.  
   4. Click **Add**.

**Can visitors submit multiple images or videos with the upload button?**

Yes. Make sure to choose **Image & Video** as the supported file type in the button settings. Then connect the button to a 'Media gallery' field type in your collection. 

1. In the upload button settings, select **Image & Video** from the **Supported file type** drop-down.
2. Drag the **Max number of files** slider to set the limit on how many files can be uploaded per submission.
3. Connect the button to a 'Media Gallery' field in your collection:  
   1. Click the **Connect to CMS** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png) on your upload button.  
   2. Click the **Choose a dataset** drop-down and select an existing dataset that connects to the collection you will store submissions in. Alternatively, select **Add a Dataset**, then choose the collection you want to store submissions in.  
   3. Add a 'Media gallery' field to your collection where you will store the upload button submissions:  
   **Tip:** Alternatively, you can connect to an existing 'Media gallery' collection field.  
         1. Click the **File connects to** drop-down and select **+ Add**.  
         2. Enter a **Field Name** for the new collection field.  
         3. Click the **Field Type** drop-down and select **Media Gallery**.  
         4. Click **Add**.

**Do I need a 'Submit' button to allow visitors to submit their uploaded files?**

Yes. Without a 'Submit' button, visitors can still upload the files, but they won't have a way to submit them to your collection. 

  
**To add a 'Submit' button:** 

1. Add a regular button in your editor and change the text to 'Submit'.
2. [Connect the button to the same dataset](https://support.wix.com/en/article/cms-connecting-a-button-to-a-dataset) that connects to your upload button.
3. Set the **Click action connects to** field to **Submit**.

  
 Learn more about [creating a 'Submit' button](https://support.wix.com/en/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-5-create-a-submit-button) for the input elements that make up your custom form.
