# Editor do Wix Studio: adicionar um elemento personalizado

Source: https://support.wix.com/pt/article/editor-do-wix-studio-adicionar-um-elemento-personalizado (updated 2026-06-04)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Melhore o site do seu cliente com seus próprios elementos. Você pode adicionar qualquer componente JavaScript ao vincular um [elemento personalizado](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/about-custom-elements) a um URL do servidor ou um arquivo de código. Se necessário, você pode definir mais atributos diretamente no editor.

> **Antes de começar:** Certifique-se de que o site do seu cliente tem um [domínio conectado](https://support.wix.com/pt/article/conectar-um-domínio-aos-servidores-de-nome-wix) e não tem anúncios Wix.

---

## O que são elementos personalizados?

Os elementos personalizados permitem que você use suas próprias tags HTML. Esses elementos funcionam em todos os navegadores compatíveis e podem ser usados com qualquer biblioteca ou estrutura JavaScript ES6 que funcione com HTML 5.

Ao incorporar um elemento personalizado, há alguns requisitos que você deve ter em mente:

* Seu arquivo JavaScript deve estar [hospedado](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/about-custom-elements#host-the-custom-element-with-wix-using-velo) no Wix usando o Velo (recomendado) ou seu próprio servidor externo ou local.
* Seu código deve conter HTTPS e não HTTP, ou ele não será exibido em seu site online.
* Seu código deve estar atualizado e ser compatível com o HTML5\. A maioria dos navegadores não exibe páginas e scripts corretamente se eles foram escritos usando versões mais antigas do JS ou HTML.
* Todas as configurações de design relevantes e funcionalidades complexas devem ser armazenadas no código JS principal, por exemplo, os CSS e outros arquivos JS. Se essas configurações forem armazenadas separadamente, isso significa que elas não funcionarão no seu site.

> **Dicas:**
>
> * Você pode usar elementos personalizados de fontes de terceiros, apenas certifique-se de atualizar o **Nome da Tag** em **Propriedades** ao adicionar o elemento personalizado à sua página.
> * O desempenho do seu elemento personalizado depende da sua implementação.

---

## Adicionar e configurar o elemento personalizado

Adicione quantos elementos personalizados forem necessários. Após arrastar um elemento personalizado para sua página, defina sua origem (URL do servidor ou um arquivo Velo) e dê a ele um nome de tag para que você o reconheça facilmente no registro da página.

### Para adicionar e configurar um elemento personalizado:

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 em **Elemento personalizado**.
4. Clique no ícone **Adicionar** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2024/07/22/e901c4fc-b4aa-48e0-81dd-8242eecca0c8/16eec3ff-490b-4c99-b97b-d08d3d8c7764.png) ao lado de **Elemento personalizado**.
5. Adicione seu arquivo de script:  
   1. Selecione o elemento personalizado.  
   2. Clique em **Escolher fonte**.  
   3. Selecione como você deseja adicionar seu elemento personalizado:  
         * **URL do servidor:** insira o URL do arquivo, incluindo o nome do arquivo.  
         * **Arquivo do Velo:** selecione um dos seus arquivos do Velo.  
   4. Insira um **Nome da tag** para seu elemento.  
   **Observação:** o nome da tag deve ter pelo menos duas palavras, separadas por um hífen (por exemplo: widget-para-previsão-do-tempo).
6. (Opcional) Ajuste o tamanho, o encaixe e o alinhamento do elemento no painel Inspetor.

> **Observações:**
>
> * Por motivos de segurança, o elemento personalizado é renderizado dentro de um iFrame no Editor e no modo de visualização. Isso pode afetar o layout do componente. **Vá para o seu site publicado para ver como ele fica online**.
> * Você pode definir as configurações de SEO do seu elemento usando a API do Velo.

---

## Definir os atributos do elemento personalizado

Faça outros ajustes nas propriedades e no comportamento do seu elemento ao definir atributos. O painel Atributos do elemento permite adicionar, editar e remover atributos diretamente do editor, sem precisar acessar o código.

> **Importante:** O código para seu elemento personalizado deve reconhecer e operar com os atributos definidos. Caso contrário, eles não funcionarão corretamente.

### Para definir os atributos do elemento personalizado:

1. Selecione o elemento personalizado.
2. Clique em **Definir Atributos**.
3. Clique em **Novo Atributo**.
4. Insira um nome para o [atributo](https://www.w3.org/TR/2011/WD-html5-20110525/syntax.html#attributes-0) (em inglês) (por exemplo: "rotação", "largura").
5. Insira o valor para o atributo (pode ser qualquer string relevante).
6. Clique em **Configurações**.

> **Procurando mais informações avançadas?** [Saiba como usar elementos personalizados](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/about-custom-elements) com o Velo by Wix. Para perguntas específicas e solução de problemas, confira nossas [FAQs sobre elementos personalizados](https://dev.wix.com/docs/develop-websites/articles/wix-editor-elements/custom-elements/custom-element-faqs).
