# CMS: conectar widgets de HTML ao CMS

Source: https://support.wix.com/pt/article/cms-conectar-widgets-de-html-ao-cms (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

Conecte widgets de HTML (iFrames) a um [conjunto de dados](https://support.wix.com/pt/article/cms-sobre-conjuntos-de-dados) para exibir sites externos (URLs) para cada item da sua coleção do CMS.

  
 Isso é útil para exibir conteúdo dinâmico, como diferentes páginas de eventos, sites de parceiros ou portfólios em que o endereço do site muda para cada item da sua coleção.

> **Observação:** No momento, você só pode conectar o elemento a um campo de coleção que contém um URL. Não é possível conectar código HTML bruto (por exemplo: <iframe src..> ) no CMS. Você pode [votar nesse recurso aqui](https://support.wix.com/pt/article/pedido-cms-vincular-o-cms-a-elementos-html-incorporados-em-páginas-dinâmicas).

---

## Conectar um widget de HTML a um conjunto de dados

Selecione um elemento de código incorporado no seu editor e conecte-o a um conjunto de dados. Em seguida, escolha se deseja exibir o código HTML ou um endereço do site (URL) nos campos da sua coleção.

  
 Selecione o widget de HTML no seu editor e conecte-o a um conjunto de dados que se conecta à sua coleção do CMS. Em seguida, escolha o campo de URL ou de Texto que contém o endereço do site que você deseja exibir.

**Editor Wix:**

1. [Vá para a página relevante no 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. Adicione o elemento Incorporar um site à sua página:  
   1. 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.  
   2. Clique em **Incorporar código**.  
   3. Clique no elemento **Incorporar um site** para adicioná-lo à sua página.
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).
4. Clique no dropdown **Escolha um novo conjunto de dados** e selecione um conjunto de dados existente que se conecte à sua coleção. Se preferir, selecione **Adicionar conjunto de dados** e escolha a coleção que deseja conectar, dê um nome ao conjunto de dados e clique em **Criar**.
5. Clique no dropdown **HTML se conecta a** e selecione o campo relevante na sua coleção:  
**Dica:** selecione **+ Adicionar** para criar e conectar um [novo campo "URL" ou "Texto" da coleção](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-adicionar-um-campo-a-uma-coleção).  
   * **URL:** (recomendado)selecione o campo "URL" que contém o endereço HTTPS que você deseja exibir.  
   * **Texto:** selecione um campo "Texto" que contém um URL com HTTPS válido.  
   **Observação:** esse campo deve conter apenas um URL. O código HTML bruto não é compatível.

![Captura de tela do elemento de incorporar código sendo conectado ao campo de URL.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/01/06/02ec9d0b-b718-41d6-bc57-c88b4ca21e26/342ea451-7662-4b14-a70a-f90a6486152b.png)

1. (Se necessário) Clique e arraste as bordas do elemento para redimensioná-lo.
2. Clique em **Visualizar** para testar suas conexões.
3. Clique em **Publicar** se as alterações estiverem prontas para ser publicadas.

**Editor do Wix Studio:**

1. [Vá para a página relevante no 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. Adicione um elemento incorporar código à sua página:  
   1. 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.  
   2. Clique em **Incorporar e redes sociais**.  
   3. Clique no elemento **Incorporar site** para adicioná-lo à página.
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 elemento.
4. Clique no dropdown **Escolha um novo conjunto de dados** e selecione um conjunto de dados existente que se conecte à sua coleção. Se preferir, selecione **Adicionar conjunto de dados** e escolha a coleção que deseja conectar, dê um nome ao conjunto de dados e clique em **Criar**.
5. Clique no dropdown **HTML se conecta a** e selecione o campo relevante na sua coleção:  
**Dica:** selecione **+ Adicionar** para criar e conectar um [novo campo "URL" ou "Texto" da coleção](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-adicionar-um-campo-a-uma-coleção).  
   * **URL:** (recomendado)selecione o campo "URL" que contém o endereço HTTPS que você deseja exibir.  
   * **Texto:** selecione um campo "Texto" que contém um URL com HTTPS válido.  
   **Observação:** esse campo deve conter apenas um URL. O código HTML bruto não é compatível.

![Captura de tela do elemento de código incorporado sendo conectado ao campo de URL.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/01/06/0517d14f-8601-4b56-b907-441e0232f9ea/fcc63bf3-75e6-4380-a747-98574cebe2c9.png)

1. (Se necessário) Clique e arraste as bordas do elemento para redimensioná-lo.
2. Clique no ícone **Visualizar** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/07/12/45e03e4e-437b-4067-977e-869c3ff1ddd7/357065e4-6113-4838-9dbd-edc880533773.png) no canto superior direito para testar suas conexões do CMS.
3. Clique em **Publicar** se as alterações estiverem prontas para ser publicadas.

---

## Perguntas frequentes

Clique abaixo para obter respostas às perguntas comuns sobre como conectar widgets de incorporar código.

**Posso conectar código HTML bruto da minha coleção?**

Não. No momento, você só pode conectar um campo que contém um URL (endereço web) válido. Se você conectar um campo de texto que contém tags HTML (por exemplo: <iframe src...> ), o código não será verificado ou renderizado.

**Posso conectar um URL HTTP?**

Não. Para garantir que seu site permaneça seguro, o Wix aceita apenas URLs **HTTPS** para conteúdo incorporado.

**Por que meu site incorporado mostra um erro de conexão recusada?**

Alguns sites têm configurações de segurança (X-Frame-Options) que impedem que eles sejam incorporados a um iframe em outros sites. Se você vir um erro "refused to connect" (recusa ao conectar), isso significa que o site externo não permite incorporação.

**Por que meu conteúdo não está sendo exibido?**

Se o seu conteúdo não estiver aparecendo:

* **Verifique o tipo de campo**: certifique-se de que você está se conectando a um campo de **Texto** ou **URL**.
* **Verifique o URL**: se estiver usando um URL, certifique-se de que ele começa com **https://** (http não é compatível).
* **Verifique o código**: se estiver usando um campo de Texto, certifique-se de que ele contém apenas um URL, não strings de código HTML bruto.

**O conteúdo incorporado é seguro?**

Sim. O Wix usa atributos de Sandbox específicos para código incorporado para garantir que seu site permaneça seguro. No entanto, sempre certifique-se de que você confia na fonte do código ou URL que você vai incorporar.

**Posso filtrar o conteúdo exibido?**

Sim. Você pode filtrar o conteúdo ao [adicionar filtros ao conjunto de dados conectado](https://support.wix.com/pt/article/cms-exibir-conteúdo-de-várias-coleções-do-banco-de-dados-usando-conjuntos-de-dados). Por exemplo, se você quiser mostrar códigos incorporados apenas para itens marcados como "Ativo", você pode adicionar um filtro ao seu conjunto de dados para excluir outros itens.

**O que é um conjunto de dados?**

Os conjuntos de dados são o elo vital entre os elementos da sua página e o conteúdo da coleção do CMS. Você pode usar conjuntos de dados para criar uma conexão bidirecional, permitindo exibir os dados da coleção, capturar entradas do usuário ou ambos.

  
 Os conjuntos de dados permitem que você controle quais partes dos elementos da sua página se conectam a quais campos da sua coleção. Cada conjunto de dados se conecta a uma coleção e cada elemento conectado ao conjunto de dados se conecta a um campo na coleção. Isso cria uma nova maneira de gerenciar qual conteúdo aparece e onde.

  
 Saiba mais sobre como [adicionar e configurar um conjunto de dados](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-adicionar-e-configurar-um-conjunto-de-dados).
