# CMS: adicionar e configurar um botão Upload

Source: https://support.wix.com/pt/article/cms-adicionar-e-configurar-um-botao-upload (updated 2026-11-16)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Crie um botão de upload para permitir que os visitantes do site enviem arquivos diretamente para suas coleções do [CMS (sistema de gerenciamento de conteúdo)](https://support.wix.com/pt/article/cms-content-management-system-an-overview). 

  
Ao conectar o botão de upload à sua coleção, você escolhe o tipo de campo da coleção que armazenará os arquivos carregados. Você pode escolher entre os tipos de campo "Imagem", "Documento", "Vídeo", "Áudio", "Galeria de mídia ou "Multidocumento". 

  
O tipo de campo que você conecta também determina o tipo de arquivo que o seu botão de upload pode aceitar. Os arquivos carregados são armazenados como novos itens em sua coleção e na seção "Uploads do visitante" do seu Gerenciador de Mídia.

> **Antes de começar:** Certifique-se de [adicionar o CMS ao seu editor](https://support.wix.com/pt/article/cms-formerly-content-manager-getting-started) se você ainda não fez isso.

> **Observação:** Os elementos de entrada não estão disponíveis no Editor do Wix Harmony, portanto, os visitantes não podem filtrar seu conteúdo ou enviar itens para sua coleção. Para coletar informações dos visitantes, adicione um formulário com Formulários Wix. Saiba mais sobre [recursos que funcionam de forma diferente no Wix Harmony](https://support.wix.com/pt/article/wix-harmony-whats-new-with-the-cms#features-that-work-differently-in-wix-harmony).

---

## Etapa 1 | Adicione o elemento Botão de upload

Vá para a página relevante no seu editor e adicione o botão de upload.

**Editor Wix:**

1. [Vá para o seu 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. Vá para a página à qual você deseja adicionar um botão de upload.
3. Clique em **Elementos** ![](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) no lado esquerdo do editor.
4. Clique em **Entrada**.
5. Clique em **Upload** em **Avançado**.
6. Clique e arraste para a página o botão de upload que você deseja usar.

![Captura de tela de um botão de upload sendo adicionado no Editor Wix.](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)

**Editor do Wix Studio:**

1. [Vá para o seu 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. Vá para a página à qual você deseja adicionar um botão de upload.
3. Clique em **Elementos** ![](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) no lado esquerdo do editor.
4. Clique em **Entrada**.
5. Clique em **Botões de upload** em **Seleções**.
6. Clique e arraste para a página o botão de upload que você deseja usar.

![Captura de tela de um botão de upload sendo adicionado no Editor Wix.](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)

---

## Etapa 2 | Conecte o CMS através de um conjunto de dados

Conecte seu botão de upload a um [conjunto de dados](https://support.wix.com/pt/article/cms-about-datasets) que se conecta ao campo da coleção do CMS onde você armazenará os envios.

**Editor Wix:**

1. No seu editor, clique no botão de upload que você acabou de adicionar.
2. Clique no ícone **Conectar ao CMS** ![](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. Clique no dropdown **Escolha um conjunto de dados** e selecione um conjunto de dados existente que se conecte à coleção em que você armazenará os envios. Se preferir, selecione **Adicionar conjunto de dados** e escolha a coleção na qual deseja armazenar os envios.
4. Adicione um campo à sua coleção onde você armazena os envios do botão de upload:  
**Dica:** como alternativa, você pode conectar a um campo de coleção existente.  
   1. Clique no dropdown **Arquivo se conecta a** e selecione **+ Adicionar**.  
   2. Insira um **Nome do campo** para o novo campo da coleção.  
   3. Selecione o **Tipo de campo** que deseja adicionar à sua coleção no dropdown. O tipo de campo determina o [tipo de arquivo que você pode armazenar no campo](https://support.wix.com/pt/article/cms-formerly-content-manager-supported-content-in-collection-field-types).  
   4. Clique em **Adicionar**.

![Captura de tela de um campo sendo adicionado ao botão de upload.](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)

**Editor do Wix Studio:**

1. No seu editor, clique no botão de upload que você acabou de adicionar.
2. Clique no ícone **Conectar ao CMS** ![](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. Clique no dropdown **Escolha um conjunto de dados** e selecione um conjunto de dados existente que se conecte à coleção em que você armazenará os envios. Se preferir, selecione **Adicionar conjunto de dados** e escolha a coleção na qual deseja armazenar os envios.
4. Adicione um campo à sua coleção onde você armazena os envios do botão de upload:  
**Dica:** como alternativa, você pode conectar a um campo de coleção existente.  
   1. Clique no dropdown **Arquivo se conecta a** e selecione **+ Adicionar**.  
   2. Insira um **Nome do campo** para o novo campo da coleção.  
   3. Selecione o **Tipo de campo** que deseja adicionar à sua coleção no dropdown. O tipo de campo determina o [tipo de arquivo que você pode armazenar no campo](https://support.wix.com/pt/article/cms-formerly-content-manager-supported-content-in-collection-field-types).  
   4. Clique em **Adicionar**.

![Captura de tela de um campo da coleção sendo adicionado para armazenar envios no botão de upload.](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)

---

## Etapa 3 | Defina o modo conjunto de dados e as permissões da coleção:

Os conjuntos de dados controlam a conexão entre seu botão de upload e sua coleção do CMS. Certifique-se de definir o modo do conjunto de dados como **Gravação** ou **Leitura e gravação** para que o botão de upload possa adicionar os arquivos à sua coleção. Se necessário, ajuste as permissões da coleção para controlar quem pode acessar o conteúdo da coleção.

**Editor Wix:**

1. No painel à direita, clique em **Configurações do conjunto de dados**.

![Captura de tela das configurações do conjunto de dados sendo clicadas no Editor Wix.](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. (Se necessário) Clique no [tipo de permissão](https://support.wix.com/pt/article/cms-collection-permissions-overview) ao lado de **Permissões** para determinar quem pode ver, adicionar, atualizar ou excluir o conteúdo da coleção.
2. Clique no dropdown **Modo do conjunto de dados** e selecione a opção relevante:  
   * **Gravação:** [os elementos de entrada](https://support.wix.com/pt/article/cms-about-user-input-elements) conectados podem adicionar novos itens à coleção, mas não podem editar itens existentes.  
   * **Leitura e gravação:** os elementos conectados podem atualizar itens existentes na coleção. Se você conectar um [botão "Novo"](https://support.wix.com/pt/article/cms-about-dataset-click-actions-for-buttons-and-images#new), os visitantes podem usá-lo para atualizar itens existentes e adicionar novos itens à sua coleção.

![Captura de tela do modo conjunto de dados sendo configurado.](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)

**Editor do Wix Studio:**

1. No painel à direita, clique em **Configurações do conjunto de dados**.

![Captura de tela das configurações do conjunto de dados sendo clicadas.](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. (Se necessário) Clique no [tipo de permissão](https://support.wix.com/pt/article/cms-collection-permissions-overview) ao lado de **Permissões** para determinar quem pode ver, adicionar, atualizar ou excluir o conteúdo da coleção.
2. Clique no dropdown **Modo do conjunto de dados** e selecione a opção relevante:  
   * **Gravação:** [os elementos de entrada](https://support.wix.com/pt/article/cms-about-user-input-elements) conectados podem adicionar novos itens à coleção, mas não podem editar itens existentes.  
   * **Leitura e gravação:** os elementos conectados podem atualizar itens existentes na coleção. Se você conectar um [botão "Novo"](https://support.wix.com/pt/article/cms-about-dataset-click-actions-for-buttons-and-images#new), os visitantes podem usá-lo para atualizar itens existentes e adicionar novos itens à sua coleção.

![Captura de tela do modo conjunto de dados sendo configurado.](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)

---

## Etapa 4 | Personalize o botão de upload

Vá para as configurações do botão de upload para definir o tipo de arquivo que o botão aceita e o número de arquivos que podem ser carregados de cada vez. Nas configurações de layout e design, você pode personalizar a aparência do botão para que ele combine com o seu site.

**Editor Wix:**

1. No seu editor, clique no botão de upload.
2. Clique em **Configurações** e edite o seguinte:  
   * **Configurações de upload:** escolha os tipos de arquivo aceitos, o número máximo de arquivos e se deseja definir como obrigatório:  
         * **Tipo de arquivo compatível:** clique no dropdown e escolha o tipo de arquivo que o botão aceita: **Imagem e vídeo**, **Imagem**, **Vídeo**, **Documento** ou **Áudio**.  
         * **Número máximo de arquivos:** arraste o slider para definir o limite de quantos arquivos podem ser carregados por envio. Se você quiser aceitar mais de um arquivo de cada vez, certifique-se de que conectou o botão a um tipo de campo "Multidocumento" ou "Galeria de mídia" em sua coleção ([consulte a Etapa 2](https://support.wix.com/pt/article/cms-adding-and-setting-up-an-upload-button?tabs=Wix-Editor-0#step-2-connect-to-the-cms-through-a-dataset)). Esses são os únicos tipos de campo que podem armazenar vários arquivos por item da coleção.  
         **Observação:** no momento, só é possível fazer upload de um arquivo de áudio de cada vez. Você pode [votar na capacidade de fazer upload de mais arquivos de áudio de cada vez](https://support.wix.com/pt/article/cms-request-allowing-visitors-to-upload-multiple-audio-files-at-once-using-the-upload-button) se quiser ver isso no futuro.  
         * **Obrigatório:** marque a caixa de seleção para tornar obrigatório que os visitantes façam upload de um arquivo antes de enviar seu formulário personalizado.  
   * **Opções de exibição:** personalize as seguintes opções:  
         * **Título do campo:** (recomendado) insira o título que aparece acima do texto do botão.  
         * **Texto do botão:** edite o texto que aparece no próprio botão.  
         * **Texto abaixo do botão:** escolha o que você deseja exibir abaixo do botão:  
                  * **Mostrar só dados do arquivo:** exiba o nome do arquivo que o visitante carregar.  
                  * **Mostrar texto personalizado:** insira o texto personalizado que deseja exibir abaixo do botão, como requisitos do arquivo. Esse texto muda para o nome do arquivo após o upload.

![Captura de tela das configurações do botão de upload.](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. Clique no ícone **Layout** ![](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) para ajustar o espaçamento, direção, alinhamento e posição do ícone. Clique em **Avançado** para definir o alinhamento e a direção de um texto específico.
2. Clique no ícone **Design** ![](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) e escolha um botão predefinido. Clique em **Personalizar design** para personalizar ainda mais o design do botão.

**Editor do Wix Studio:**

1. No seu editor, clique no botão de upload.
2. Clique em **Configurações** e edite o seguinte:  
   * **Configurações de upload:** escolha os tipos de arquivo aceitos, o número máximo de arquivos e se deseja definir como obrigatório:  
         * **Tipo de arquivo compatível:** clique no dropdown e escolha o tipo de arquivo que o botão aceita: **Imagem e vídeo**, **Imagem**, **Vídeo**, **Documento** ou **Áudio**.  
         * **Número máximo de arquivos:** arraste o slider para definir o limite de quantos arquivos podem ser carregados por envio. Se você quiser aceitar mais de um arquivo de cada vez, certifique-se de que conectou o botão a um tipo de campo "Multidocumento" ou "Galeria de mídia" em sua coleção ([consulte a Etapa 2](https://support.wix.com/pt/article/cms-adding-and-setting-up-an-upload-button?tabs=Studio-Editor-1#step-2-connect-to-the-cms-through-a-dataset)). Esses são os únicos tipos de campo que podem armazenar vários arquivos por item da coleção.  
         **Observação:** no momento, só é possível fazer upload de um arquivo de áudio de cada vez. Você pode [votar na capacidade de fazer upload de mais arquivos de áudio de cada vez](https://support.wix.com/pt/article/cms-request-allowing-visitors-to-upload-multiple-audio-files-at-once-using-the-upload-button) se quiser ver isso no futuro.  
         * **Obrigatório:** marque a caixa de seleção para tornar obrigatório que os visitantes façam upload de um arquivo antes de enviar seu formulário personalizado.  
   * **Opções de exibição:** personalize as seguintes opções:  
         * **Título do campo:** (recomendado) insira o título que aparece acima do texto do botão.  
         * **Texto do botão:** edite o texto que aparece no próprio botão.  
         * **Texto abaixo do botão:** escolha o que você deseja exibir abaixo do botão:  
                  * **Mostrar só dados do arquivo:** exiba o nome do arquivo que o visitante carregar.  
                  * **Mostrar texto personalizado:** insira o texto personalizado que deseja exibir abaixo do botão, como requisitos do arquivo. Esse texto muda para o nome do arquivo após o upload.

![Captura de tela das configurações do botão de upload no Editor do Wix Studio.](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. Clique no ícone **Layout** ![](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) para ajustar o espaçamento, direção, alinhamento e posição do ícone. Clique em **Avançado** para definir o alinhamento e a direção de um texto específico.
2. Clique no ícone **Design** ![](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) no painel Inspetor à direita para personalizar a aparência do botão de upload.

---

## Etapa 5 | Crie um botão de envio

Você precisa criar uma maneira para os visitantes enviarem os arquivos que fazem upload com o botão. Adicione um botão normal ou uma imagem e conecte ao mesmo conjunto de dados que se conecta à sua coleção de envios. Em seguida, defina a ação de clique do botão ou imagem como **Enviar**. Isso permite que a seleção do dropdown "grave" ou crie um novo item na coleção de envios quando o botão Enviar for clicado. 

  
Se você conectar [outros elementos de entrada](https://support.wix.com/pt/article/cms-about-user-input-elements) ao mesmo conjunto de dados, o botão de envio também envia suas entradas para a coleção.

> Saiba como [criar um botão de envio](https://support.wix.com/pt/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-5-create-a-submit-button) para o seu botão de upload.

![Captura de tela de um botão Enviar abaixo do botão de upload.](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)

---

## Perguntas frequentes

Clique abaixo para obter respostas a perguntas comuns sobre o botão de upload.

**Como faço para conectar um tipo de campo "Multidocumento"?**

1. Selecione **Documento** no dropdown **Tipo de arquivo compatível** nas configurações do botão de upload.
2. Arraste o slider **Número máximo de arquivos** para definir o limite de quantos arquivos podem ser carregados por envio.
3. Clique no ícone **Conectar ao CMS** ![](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) no botão de upload.
4. Clique no dropdown **Escolha um conjunto de dados** e selecione um conjunto de dados existente que se conecte à coleção em que você armazenará os envios. Se preferir, selecione **Adicionar conjunto de dados** e escolha a coleção na qual deseja armazenar os envios.
5. Adicione um campo "Multidocumento" à sua coleção onde você armazena os envios do botão de upload:  
**Dica:** como alternativa, você pode conectar a um campo de coleção "Multidocumento" existente.  
   1. Clique no dropdown **Arquivo se conecta a** e selecione **+ Adicionar**.  
   2. Insira um **Nome do campo** para o novo campo da coleção.  
   3. Clique no dropdown **Tipo de campo** e selecione **Multidocumento**.  
   4. Clique em **Adicionar**.

**Os visitantes podem enviar várias imagens ou vídeos com o botão de upload?**

Sim. Certifique-se de escolher **Imagem e vídeo** como o tipo de arquivo compatível nas configurações do botão. Em seguida, conecte o botão a um tipo de campo "Galeria de mídia" na sua coleção. 

1. Nas configurações do botão de upload, selecione **Imagem e vídeo** no dropdown **Tipo de arquivo compatível**.
2. Arraste o slider **Número máximo de arquivos** para definir o limite de quantos arquivos podem ser carregados por envio.
3. Conecte o botão a um campo "Galeria de mídia" na sua coleção:  
   1. Clique no ícone **Conectar ao CMS** ![](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) no botão de upload.  
   2. Clique no dropdown **Escolha um conjunto de dados** e selecione um conjunto de dados existente que se conecte à coleção em que você armazenará os envios. Se preferir, selecione **Adicionar conjunto de dados** e escolha a coleção na qual deseja armazenar os envios.  
   3. Adicione um campo "Galeria de mídia" à sua coleção para armazenar os envios do botão de upload:  
   **Dica:** como alternativa, você pode conectar a um campo de coleção "Galeria de mídia" existente.  
         1. Clique no dropdown **Arquivo se conecta a** e selecione **+ Adicionar**.  
         2. Insira um **Nome do campo** para o novo campo da coleção.  
         3. Clique no dropdown **Tipo de campo** e selecione **Galeria de mídia**.  
         4. Clique em **Adicionar**.

**Eu preciso de um botão "Enviar" para permitir que os visitantes enviem os arquivos que eles carregaram?**

Sim. Sem um botão "Enviar", os visitantes podem fazer upload dos arquivos, mas não podem enviá-los para sua coleção. 

  
**Para adicionar um botão "Enviar":** 

1. Adicione um botão normal no seu editor e altere o texto para "Enviar".
2. [Conecte o botão ao mesmo conjunto de dados](https://support.wix.com/pt/article/cms-connecting-a-button-to-a-dataset) que se conecta ao seu botão de upload.
3. Defina o campo **A ação do clique se conecta a** como **Enviar**.

  
Saiba mais sobre [como criar um botão "Enviar"](https://support.wix.com/pt/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection#step-5-create-a-submit-button) para os elementos de entrada que formam o seu formulário personalizado.
