# CMS: solução de problemas da coleção

Source: https://support.wix.com/pt/article/cms-solucao-de-problemas-da-colecao (updated 2026-11-10)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Gerenciar coleções no seu CMS (sistema de gerenciamento de conteúdo) às vezes pode apresentar desafios. Seja conectando elementos da página, definindo permissões ou sincronizando conteúdo, a resolução desses problemas garante que seu site funcione corretamente. Por exemplo, imagine um corretor imobiliário que atualiza a lista de propriedades, mas descobre que as novas propriedades não estão sendo exibidas corretamente em seu site. Este guia ajudará a resolver problemas como esse.

> **Dica: ** Você pode solucionar muitos problemas com coleções na página Ver conexões em sua coleção. 
>
> 1. [Vá para CMS](https://www.wix.com/my-account/site-selector/?buttonText=Ir%20para%20CMS&title=Selecione%20um%20site&autoSelectOnSingleSite=true&actionUrl=https://www.wix.com/dashboard/%7B%7BmetaSiteId%7D%7D/database/) no painel de controle do seu site.
> 2. Clique na coleção desejada.
> 3. Clique em **Mais ações** no canto superior direito e selecione **Ver conexões**.

> **Observação:** Os sites criados com o Editor do Wix Harmony não usam conjuntos de dados, coleções Sandbox ou a página Ver conexões. Para verificar o que está conectado, clique no seu repetidor e clique em **Gerenciar itens**. Saiba mais sobre [o que há de novo com o CMS no Wix Harmony](https://support.wix.com/pt/article/wix-harmony-whats-new-with-the-cms).

---

## Verificar as conexões dos elementos da página

Após criar uma coleção e adicionar um conjunto de dados à sua página, certifique-se de que todos os elementos e entradas do usuário estejam conectados ao conjunto de dados. Isso garante que o conteúdo seja exibido corretamente. Certifique-se de que todos os elementos, como imagens, texto e botões, estejam conectados corretamente ao conjunto de dados relevante.

> Saiba como [verificar as conexões do conjunto de dados](https://support.wix.com/pt/article/cms-formerly-content-manager-adding-and-setting-up-a-dataset#step-4-connect-page-elements-to-the-dataset) entre seus elementos e suas coleções.

---

## Verificar suas permissões de coleção

As permissões controlam quem pode visualizar, criar, atualizar e excluir o conteúdo de uma coleção. Certifique-se de que você tem as permissões corretas definidas e que elas estão alinhadas com as funções dos usuários do seu site. No painel de controle do CMS do seu site, um ícone de aviso aparece na coluna **Permissões** quando as permissões de uma coleção estão configuradas incorretamente.

> **Saiba como: **
>
> * [Verifique as permissões da sua coleção](https://support.wix.com/pt/article/cms-changing-your-collection-permissions) para garantir que elas estejam definidas corretamente.
> * [Gerencie suas coleções no painel de controle do CMS](https://support.wix.com/pt/article/cms-managing-your-collections-from-the-cms-dashboard).

---

## Sincronizar seu Sandbox opcional e coleções Live

Se você ativou coleções Sandbox, lembre-se de que as alterações em uma não afetam a outra. Sincronize o conteúdo para garantir que as atualizações entrem em vigor. Sincronize regularmente suas coleções para evitar discrepâncias entre os dados do Sandbox e da coleção Live.

> Se você ativou coleções Sandbox, saiba como [sincronizar o conteúdo da sua coleção Sandbox e Live](https://support.wix.com/pt/article/cms-accessing-and-syncing-your-sandbox-and-live-collections#accessing-and-syncing-sandbox-and-live-collections).

---

## Verificar o modo do seu conjunto de dados

Os conjuntos de dados controlam como os visitantes do site interagem com o conteúdo de suas coleções. Verifique se o conjunto de dados está definido para o modo apropriado. Você pode escolher entre os seguintes modos de conjunto de dados: 

* **Leitura:** os elementos conectados podem ler e exibir dados da sua coleção. Os elementos não podem modificar o conteúdo da coleção.
* **Gravação:** os elementos conectados não podem exibir dados da coleção. Os [elementos de entrada](https://support.wix.com/pt/article/cms-about-user-input-elements) podem adicionar conteúdo à coleção, mas não podem modificar o conteúdo existente da coleção.
* **Leitura e gravação:** os elementos conectados podem exibir dados da sua coleção. Os elementos de entrada podem adicionar ou editar o conteúdo da sua coleção.

> Saiba como [editar seu modo conjunto de dados](https://support.wix.com/pt/article/cms-formerly-content-manager-adding-and-setting-up-a-dataset#step-3-edit-the-dataset-settings) e outras configurações do conjunto de dados.

---

## Verificar as configurações do seu navegador

Se o seu navegador bloquear cookies de terceiros, você pode ter problemas para exibir ou editar seu conteúdo. [Certifique-se de que seu navegador não está bloqueando nenhum cookie do Wix](https://support.wix.com/pt/article/enabling-cookies-in-your-browser).

---

## Verificar problemas ao adicionar a uma coleção

Vários cenários podem impedir que você adicione itens a uma coleção. Confira como solucionar problemas comuns:

**Não há permissões suficientes para adicionar um item**

Com acesso limitado, você pode ler ou atualizar o conteúdo existente, mas não pode adicionar novos itens. Essa mensagem de erro será exibida: "Você não tem permissão para adicionar itens a uma coleção. Entre em contato com o proprietário para obter acesso."

  
![Uma captura de tela de uma mensagem sobre permissão - informando ao usuário para entrar em contato com o proprietário para obter acesso](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2022/04/14/53724582-322f-4ba2-b431-2833d135168c/2c023a88-0aeb-4af3-a282-ae6eec1a922c.png)

  
**Para resolver:** entre em contato com o proprietário do site e peça para que ele [atribua a você uma função com mais permissões](https://support.wix.com/pt/article/cms-formerly-content-manager-creating-custom-roles-and-permissions).

**Coleções de apps do Wix e coleções externas**

[Coleções de apps do Wix](https://support.wix.com/pt/article/cms-formerly-content-manager-working-with-wix-app-collections) (por exemplo: Wix Blog, Wix Stores, Wix Events) são "somente leitura" por padrão. [Coleções externas](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site) podem ter permissões misturadas. A mensagem de erro será exibida: "Você não pode adicionar itens a esse tipo de coleção".

  
![Uma captura de tela de uma mensagem informando ao usuário que ele não pode adicionar itens a um tipo de coleção](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2022/04/14/f261bbc1-297b-41db-8787-26df3a6d61b5/b0abb79f-ce79-4146-bf28-17d8cf3f2a40.png)

  
**Para resolver:** abra a seção relevante no painel de controle (por exemplo: Wix Blog, Wix Stores) e adicione o item. Para coleções externas, peça ao proprietário do site para ajustar as configurações.

**O servidor retorna um erro de ID do item de coleção**

Esse erro pode ocorrer por vários motivos, exibindo uma mensagem de erro na área de conteúdo da coleção. O cabeçalho e as opções da coleção, incluindo o botão **+ Adicionar item**, ainda são visíveis.

  
**Para resolver:** atualize a coleção e tente adicionar um item novamente. Se o problema persistir, [entre em contato com o Apoio ao Cliente](https://www.wix.com/support/conversations/category/contact).

**Uma coleção não está disponível (excluída, não existe ou o servidor não consegue encontrá-la)**

Se uma coleção for excluída ou estiver indisponível, uma mensagem de erro será exibida que você fique sabendo. 

  
![Uma captura de tela de uma mensagem informando ao usuário que sua coleção não existe mais e que ele deve escolher outra](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2022/04/14/4bf2bdfc-283c-4cdb-9bcf-e8273a52c5c4/3b4ac8da-3547-4074-a6af-116d28dd7d23.png)

  
**Para resolver:**  se uma coleção foi excluída por engano, [use backups para restaurá-la](https://support.wix.com/pt/article/cms-formerly-content-manager-backing-up-your-collections).

---

## Verificar os tipos de campo da sua coleção

O tipo de campo da coleção determina que tipo de dados você pode armazenar nos campos de coleção. Por exemplo, você pode armazenar apenas valores numéricos em um tipo de campo Número. Os elementos que você conecta ao CMS também têm limitações sobre quais tipos de campos eles podem conectar. Por exemplo, o elemento Rich content só pode se conectar ao tipo de campo Rich content.

  
Se você estiver com problemas para armazenar o tipo correto de dados em seus campos ou para conectar elementos a eles, verifique se você está usando os tipos de campo corretos.

> Saiba mais sobre [os tipos de conteúdo que você pode armazenar em cada tipo de campo da coleção](https://support.wix.com/pt/article/cms-formerly-content-manager-supported-content-in-collection-field-types).

---

## Perguntas frequentes

Clique abaixo para saber como solucionar outros problemas com a coleção.

**Por que recebo a mensagem: "A coleção não foi carregada devido a um erro de sintaxe"?**

Esse erro pode ocorrer se você estiver usando o Velo e hooks de dados. Se você receber esse erro, revise seu arquivo **data.js** e confirme se a sintaxe e a formatação estão corretas. Saiba mais sobre como [usar hooks de dados no Velo](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/hooks/using-data-hooks).

**Por que recebo um erro "O servidor não responde" quando minha coleção não é carregada?**

Se você receber uma mensagem de erro "O servidor não respondeu", atualize a página e tente novamente. 

  
Se ainda não carregar, vá para o [painel de Monitoramento](https://dev.wix.com/docs/develop-websites/articles/workspace-tools/testing-monitoring/monitoring-your-published-site/working-with-the-monitoring-dashboard), clique na aba **Solicitações de dados** e selecione a coleção relevante. Em seguida, verifique os [códigos de erro](https://www.wix.com/velo/reference/wix-data/error-codes#wix-data%5Ferror-codes%5Fwix-data-error-codes) (em inglês) na seção **Solicitações de dados com falhas por erro** para saber como resolver o problema. 

  
Confira um tutorial em inglês sobre como [monitorar seu código para desempenho e tratamento de erros](https://www.wix.com/studio/academy/tutorials/monitor-your-code-performance-and-error-handling-wix-studio) na Wix Studio Academy. 

  
Se você ainda precisar de ajuda, [entre em contato conosco](https://www.wix.com/support/conversations/category/contact) para obter suporte.

**Por que minha coleção leva muito tempo para carregar?**

Se você tiver milhares de itens ou um grande número de itens referenciados, pode levar mais tempo do que o esperado para que sua coleção seja carregada. 

  
Você pode resolver esse problema ao [adicionar índices](https://support.wix.com/pt/article/cms-adding-an-index-for-your-collection) a coleções maiores ou às coleções que estão sendo referenciadas. Por exemplo, se uma coleção tiver 10 itens, mas tiver campos de várias referências para 20 outras coleções, a coleção com 10 itens pode carregar lentamente. Nesse caso, você pode usar um índice nas 20 coleções referenciadas para melhorar a velocidade de recuperação de dados.

**Por que minhas páginas dinâmicas do CMS estão mostrando um erro 404?**

Um erro 404 nas páginas dinâmicas do seu site online geralmente significa que a coleção do CMS ou a página dinâmica não está conectada corretamente. Verifique a coleção do CMS para garantir que todos os itens estejam publicados e vinculados corretamente à página dinâmica. Além disso, verifique se a estrutura do URL da página dinâmica corresponde aos valores de campo na sua coleção. Se você alterou recentemente a estrutura do URL ou as configurações de SEO, atualize os links conforme necessário.

  
**Dica:** se o problema persistir, limpar o cache do seu navegador ou tentar acessar a página a partir de uma janela anônima para descartar problemas de armazenamento em cache.

**Por que meu repetidor, galeria ou tabela não está exibindo os dados corretos do CMS?**

Certifique-se de que o repetidor, galeria ou tabela está conectado corretamente ao conjunto de dados relevante. Verifique se o conjunto de dados está vinculado à coleção do CMS correta e se os campos no repetidor estão mapeados para os campos da coleção corretos.

  
**Dica:** se estiver usando coleções Sandbox, após fazer alterações, sempre sincronize as coleções Sandbox e Live para garantir que os dados estejam atualizados no seu site online.

**Como posso aumentar o número de itens exibidos em uma página dinâmica ou repetidor?**

Abra as configurações do conjunto de dados no editor e ajuste o campo **Itens por carregamento** que controla o número máximo de itens exibidos na página. Por exemplo, aumente o limite de 13 para um número mais alto, como 20 ou 25.

  
**Dica:** se você tiver uma coleção grande, considere adicionar uma [barra de paginação](https://support.wix.com/pt/article/cms-adding-and-setting-up-a-pagination-bar) ou um [botão "Ver mais"](https://support.wix.com/pt/article/cms-about-dataset-click-actions-for-buttons-and-images#load-more).

**Por que algumas imagens na minha coleção do CMS aparecem quebradas ou corrompidas?**

Isso pode acontecer se as imagens não foram carregadas corretamente ou se foram corrompidas durante o processo de upload. Exclua as imagens corrompidas do CMS e faça upload delas novamente. Você também pode adicionar imagens aos campos de coleção do CMS ao colar os URLs das imagens nos campos. 

  
**Observação:** sempre certifique-se de que suas imagens tenham menos de 25 MB cada e estejam em formatos compatíveis: JPG, PNG, SVG ou GIF

**Por que valores vazios aparecem na minha coleção do CMS e eu posso excluí-los?**

Valores vazios no seu banco de dados do CMS podem ocorrer se os campos tiverem sido adicionados, mas não preenchidos. Se as entradas vazias não estiverem conectadas a nenhuma página ou elemento online, você pode excluí-las com segurança.

  
**Observação:** antes de excluir, verifique se nenhum elemento do site online depende desses valores vazios.

**Por que não consigo excluir minha coleção?**

Você não pode excluir uma coleção enquanto outras coleções fizerem referência aos seus dados. Verifique a coluna **Relações** no seu painel de controle do CMS para ver quais coleções usam os dados da coleção. Em seguida, remova esses campos de referência ou atualize-os para que apontem para uma coleção diferente. Nessa página, você pode [excluir a coleção](https://support.wix.com/pt/article/cms-formerly-content-manager-deleting-a-collection).
