Access SecurityCONSENT

Central de ajuda › Instalação

Instalar por plataforma

Passo a passo para Nuvemshop, Shopify, VTEX, Tray, Loja Integrada, Wake, WooCommerce, Wix, Webflow, Squarespace, Magento, PrestaShop, Joomla, Next.js, React e GTM.

No painel, a aba Instalação de cada site mostra estes mesmos passos com a chave do site já preenchida, os botões para baixar o plugin WordPress e o modelo do GTM, o botão Verificar instalação (confere a página inicial e mostra o que corrigir) e Enviar instruções ao desenvolvedor (por e-mail, com links de download válidos por 7 dias).

Lojas virtuais: Nuvemshop · Shopify · VTEX · Tray · Loja Integrada · Wake (ex-Linx Commerce) · WooCommerce

Criadores de sites: Wix · Webflow · Squarespace

Outros (CMS, código e GTM): WordPress · Magento / Adobe Commerce · PrestaShop · Joomla · HTML / site próprio · Next.js · React (SPA) · Google Tag Manager

Em todas as plataformas

  • Ordem: O script do Access Consent tem de vir antes de qualquer tag de análise ou publicidade (Google Analytics, Meta, Google Ads, Hotjar, TikTok…), de preferência como o primeiro script do <head>.
  • Bloqueio automático: Para segurar sozinho as tags conhecidas até o aceite, troque async por data-autoblock="true" (o script fica síncrono, no topo do <head>). Depois de ligar, navegue pelo site e confira se nada quebrou.
  • Google Consent Mode v2: O script já declara o padrão do Consent Mode (tudo negado, exceto segurança) e atualiza quando o visitante decide. Não configure outro padrão em paralelo.
  • Como testar: Abra o site numa janela anônima: o aviso tem de aparecer. Clique em Verificar instalação nesta aba e, depois de aceitar ou recusar, confira se a decisão chegou em Registros.

O código padrão, para qualquer plataforma que permita incluir código no <head>:

<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>

Nuvemshop

App do Access Consent (sem editar o layout) ou Google Tag Manager em Códigos externos.

Onde: App do Access Consent; sem app, contêiner do GTM em Configurações → Códigos externos.

No painel, Sites → seu site → Instalação → Baixar modelo do GTM.

Com o app do Access Consent:

  1. Nesta página, abra a aba Integrações e clique em Conectar loja Nuvemshop.
  2. Autorize o app na Nuvemshop: você volta para cá e o script entra na loja sozinho, em todas as páginas.
  3. Cadastre em Configuração todos os domínios da loja (o sualoja.lojavirtualnuvem.com.br e o domínio próprio).

Sem o app:

  1. Crie (ou use) um contêiner do Google Tag Manager e instale nele o modelo do Access Consent:
  2. Baixe o modelo do GTM (botão nesta aba) e, no Google Tag Manager, vá em Modelos → Modelos de tag → Novo → ⋮ → Importar e salve.
  3. Em Tags → Nova, escolha o modelo Access Consent (LGPD) e preencha a Chave do site (CHAVE-DO-SITE).
  4. Acionador: Consent Initialization – All Pages. Salve e publique o contêiner.
  5. Na Nuvemshop, vá em Configurações → Códigos externos → Google e cole o ID do contêiner (GTM-…) no campo do Google Tag Manager. Salve.
  6. Se o campo do GTM não aparecer, peça ao suporte da Nuvemshop para liberá-lo (é dos planos pagos).
  • O antigo campo Códigos de rastreamento foi desativado pela Nuvemshop: scripts para todas as páginas vão pelo GTM.
  • Pixels configurados pelos campos nativos da Nuvemshop (Meta, Google Ads) não passam pelo aviso. Prefira configurá-los no GTM, com as configurações de consentimento.

Mais detalhes: App Nuvemshop.

Shopify

App embed do Access Consent no tema, ou o script no theme.liquid antes do content_for_header.

Onde: layout/theme.liquid, logo depois de <head> e antes de {{ content_for_header }}.

Com o app do Access Consent:

  1. Instale o app Access Consent pela Shopify App Store (ou use o link de ativação na aba Integrações).
  2. Loja virtual → Temas → Personalizar → Incorporações de app: ligue Access Consent, cole a chave CHAVE-DO-SITE e salve.
  3. Desligue o banner nativo em Configurações → Privacidade do cliente → Banner de cookies e qualquer outro app de cookies.

Sem o app:

  1. Desligue o banner nativo (Configurações → Privacidade do cliente → Banner de cookies) e qualquer app de cookies, para não aparecerem dois avisos.
  2. Loja virtual → Temas → ⋯ → Editar código e abra layout/theme.liquid.
  3. Cole o código logo depois de <head>, antes de {{ content_for_header }} (é ali que a Shopify injeta pixels e apps). Salve.
  4. Link de preferências no rodapé (sections/footer.liquid): <a href="#" data-consent-open>Preferências de cookies</a>.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • A escolha é repassada sozinha à Customer Privacy API da Shopify: os pixels da Shopify, os dos apps e o checkout respeitam a decisão.
  • Cadastre o domínio sualoja.myshopify.com além do domínio próprio.

Mais detalhes: App Shopify.

VTEX

Store Framework (VTEX IO): app nativo do Google Tag Manager ou um pixel app; CMS legado: template HTML.

Onde: VTEX IO: GTM (app nativo) ou pixel/head.html de um pixel app; CMS legado: <head> do template base.

No painel, Sites → seu site → Instalação → Baixar modelo do GTM.

  1. Store Framework (VTEX IO), caminho simples: instale o app nativo Google Tag Manager da VTEX (Admin → Apps), informe o ID do contêiner e instale nele o modelo do Access Consent:
  2. Baixe o modelo do GTM (botão nesta aba) e, no Google Tag Manager, vá em Modelos → Modelos de tag → Novo → ⋮ → Importar e salve.
  3. Em Tags → Nova, escolha o modelo Access Consent (LGPD) e preencha a Chave do site (CHAVE-DO-SITE).
  4. Acionador: Consent Initialization – All Pages. Salve e publique o contêiner.
  5. Store Framework, com bloqueio no HTML: um desenvolvedor VTEX IO cria um *pixel app* com o código em pixel/head.html (roda no <head>, antes do resto da página) e o instala na conta.
  6. CMS legado (Portal): Storefront → Layout (CMS) → HTML Templates: cole o código no <head> do template base, antes das outras tags, e o link de preferências no rodapé.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • No Store Framework o link de preferências precisa de um componente que chame AccessConsent.open().
  • Cadastre também sualoja.vtexcommercestable.com.br e sualoja.myvtex.com se o visitante passar por eles.

Mais detalhes: Shopify, VTEX, Nuvemshop e Wix.

Tray

Edição do HTML do layout (cabeçalho) ou Google Tag Manager.

Onde: Arquivo de cabeçalho do tema, no <head>, antes das outras tags.

No painel, Sites → seu site → Instalação → Baixar modelo do GTM.

  1. Duplique o tema antes de mexer (cópia de segurança).
  2. No painel da Tray, em Minha Loja → Editar Layout → Editar HTML, abra o arquivo de cabeçalho do tema.
  3. Cole o código no começo do <head>, antes de qualquer outra tag de análise ou publicidade, e salve.
  4. Sem acesso ao HTML do tema: use o Google Tag Manager com o modelo do Access Consent.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • O nome do arquivo e do menu muda conforme o tema e a versão do painel.

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

Loja Integrada

Google Tag Manager (recomendado) ou campo de código HTML no cabeçalho, se o seu plano tiver.

Onde: Contêiner do GTM com o modelo do Access Consent; ou campo de código no cabeçalho da loja.

No painel, Sites → seu site → Instalação → Baixar modelo do GTM.

  1. Caminho recomendado: instale o modelo do Access Consent no seu contêiner do Google Tag Manager:
  2. Baixe o modelo do GTM (botão nesta aba) e, no Google Tag Manager, vá em Modelos → Modelos de tag → Novo → ⋮ → Importar e salve.
  3. Em Tags → Nova, escolha o modelo Access Consent (LGPD) e preencha a Chave do site (CHAVE-DO-SITE).
  4. Acionador: Consent Initialization – All Pages. Salve e publique o contêiner.
  5. No painel da Loja Integrada, informe o ID do contêiner (GTM-…) na integração com o Google Tag Manager.
  6. Se o seu plano tem campo de código HTML para o cabeçalho de todas as páginas, você pode colar o código direto lá — no começo, antes das outras tags.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

Wake (ex-Linx Commerce)

Google Tag Manager ou campo de scripts do cabeçalho nas configurações do tema.

Onde: Contêiner do GTM; ou campo de scripts do <head> do tema.

No painel, Sites → seu site → Instalação → Baixar modelo do GTM.

  1. Caminho recomendado: modelo do Access Consent no Google Tag Manager da loja:
  2. Baixe o modelo do GTM (botão nesta aba) e, no Google Tag Manager, vá em Modelos → Modelos de tag → Novo → ⋮ → Importar e salve.
  3. Em Tags → Nova, escolha o modelo Access Consent (LGPD) e preencha a Chave do site (CHAVE-DO-SITE).
  4. Acionador: Consent Initialization – All Pages. Salve e publique o contêiner.
  5. Com campo de scripts de cabeçalho nas configurações do tema/conteúdo, cole o código no começo do campo do <head>, salve e limpe o cache da loja.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • Se a loja é headless (front próprio), siga o cartão do framework usado (Next.js, React…).

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

WooCommerce

Plugin do Access Consent para WordPress, já com a chave do site.

Onde: Plugin (Configurações → Access Consent).

No painel, Sites → seu site → Instalação → Baixar plugin WordPress (o .zip já vem com a chave).

  1. Baixe o plugin pronto (botão nesta aba): ele já vem com a chave CHAVE-DO-SITE.
  2. No WordPress: Plugins → Adicionar novo → Enviar plugin, escolha o .zip, instale e ative.
  3. Confira em Configurações → Access Consent (a chave já aparece; dá para trocar ali). Opcional: idioma e bloqueio automático.
  4. Rodapé: adicione o shortcode [access_consent_preferences] (widget ou bloco "Shortcode").
  • Com o plugin WP Consent API instalado, a escolha é repassada ao WooCommerce, ao Site Kit e a outros plugins.
  • Plugins de otimização (WP Rocket, LiteSpeed, Autoptimize…): exclua consent.js de "adiar/atrasar JavaScript" e de "combinar JS".
  • Funciona igual com Elementor, Divi e outros construtores: o plugin coloca o script no <head> de todas as páginas.

Mais detalhes: WordPress e WooCommerce.

Wix

Código personalizado do painel do site, no cabeçalho, em todas as páginas.

Onde: Configurações → Código personalizado → Head, "Todas as páginas", "Carregar o código uma vez".

  1. No painel do site, abra Configurações → Código personalizado (em Avançado) e clique em + Adicionar código personalizado.
  2. Cole o código, dê um nome (ex.: "Access Consent") e escolha Todas as páginas e Carregar o código uma vez.
  3. Em Colocar o código em, escolha Head. Aplique.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • O Wix só permite código personalizado em site publicado com domínio conectado (plano pago).
  • Na lista de códigos, deixe o do Access Consent acima dos outros (ordem de carregamento).

Webflow

Configurações do site → Código personalizado → Código do head.

Onde: Site settings → Custom code → Head code.

  1. Abra Site settings → Custom code.
  2. Cole o código no começo do campo Head code (antes de outras tags) e salve.
  3. Publique o site: o código só vai para o ar depois de publicar.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • O código personalizado exige um plano de site pago.

Squarespace

Injeção de código → Cabeçalho (todas as páginas).

Onde: Configurações → Avançado → Injeção de código → Cabeçalho.

  1. Abra Configurações → Avançado → Injeção de código (Code Injection).
  2. Cole o código no começo do campo Cabeçalho (Header) e salve.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • A injeção de código depende do plano do Squarespace (não existe no plano de entrada).

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

WordPress

Plugin do Access Consent já com a chave do site (vale para Elementor, Divi e outros).

Onde: Plugin (Configurações → Access Consent); sem plugin, wp_head no functions.php do tema filho.

No painel, Sites → seu site → Instalação → Baixar plugin WordPress (o .zip já vem com a chave).

  1. Baixe o plugin pronto (botão nesta aba): ele já vem com a chave CHAVE-DO-SITE.
  2. No WordPress: Plugins → Adicionar novo → Enviar plugin, escolha o .zip, instale e ative.
  3. Confira em Configurações → Access Consent (a chave já aparece; dá para trocar ali).
  4. Rodapé: shortcode [access_consent_preferences].
  5. Sem plugin: no functions.php do tema filho, use o código abaixo.
add_action( 'wp_head', function () {
    echo '<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>';
}, 1 );
  • Plugins de otimização: exclua consent.js de "adiar/atrasar JavaScript" e de "combinar JS".

Mais detalhes: WordPress e WooCommerce.

Magento / Adobe Commerce

Content → Design → Configuration → HTML Head → Scripts and Style Sheets.

Onde: Campo Scripts and Style Sheets do HTML Head (escopo global ou da loja).

  1. No admin, vá em Content → Design → Configuration e edite o escopo certo (Global ou a store view).
  2. Abra HTML Head e cole o código no começo de Scripts and Style Sheets. Salve.
  3. Limpe o cache em System → Cache Management.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • Se o tema tem minificação/merge de JS, deixe o consent.js fora do merge.

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

PrestaShop

Template do cabeçalho do tema (head.tpl) ou um módulo de código no head.

Onde: themes/SEU-TEMA/templates/_partials/head.tpl, no começo do <head>.

  1. Em um tema filho, abra templates/_partials/head.tpl e cole o código no começo, antes das outras tags.
  2. Ou use um módulo que insira código no <head> (hook displayHeader).
  3. Limpe o cache em Parâmetros avançados → Desempenho.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • O caminho do arquivo muda entre versões (1.7, 8, 9) e temas.

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

Joomla

Campo de código personalizado do template ou extensão de código no head.

Onde: Opções do template (aba de código personalizado/head) ou index.php do template.

  1. Em Sistema → Templates do site → seu template, procure a aba de código personalizado do <head> e cole o código.
  2. Se o template não tem esse campo, use uma extensão de "código no head" ou edite o index.php do template logo depois de <head>.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>

Os nomes dos menus mudam com a versão e o plano da plataforma: confira na sua plataforma. Depois de instalar, use Verificar instalação no painel.

HTML / site próprio

O script no <head> de todas as páginas, antes das tags de terceiros.

Onde: No <head> de todas as páginas (ou no template/layout comum).

  1. Cole o código no <head> de todas as páginas, como primeiro script.
  2. Rodapé: <a href="#" data-consent-open>Preferências de cookies</a>.
  3. Se o site usa Content-Security-Policy, acrescente o endereço do Access Consent em script-src e connect-src.
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>

Mais detalhes: Instalar o aviso.

Next.js

next/script com strategy="beforeInteractive" no layout raiz (App Router) ou no _document (Pages Router).

Onde: app/layout.tsx (App Router) ou pages/_document.tsx (Pages Router).

  1. App Router: no app/layout.tsx, use <Script strategy="beforeInteractive"> com a chave na URL (consent.js?site=…). O Next.js coloca o script no <head> e o carrega antes do código da aplicação.
  2. Pages Router: use o mesmo <Script strategy="beforeInteractive"> dentro do pages/_document.tsx.
  3. Link de preferências: um botão que chama window.AccessConsent?.open().
// app/layout.tsx
import Script from 'next/script';

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="pt-BR">
      <body>
        {children}
        <Script src="https://consent.accesssecurity.com.br/consent.js?site=CHAVE-DO-SITE" strategy="beforeInteractive" />
      </body>
    </html>
  );
}
  • A chave vai na URL (?site=) e não em data-site: com beforeInteractive no App Router, atributos data-* podem não chegar ao HTML.
  • Com CSP por nonce, passe o nonce também.

React (SPA)

O script no <head> do index.html (Vite, Create React App e afins).

Onde: index.html (Vite: na raiz; Create React App: public/index.html).

  1. Cole o código no <head> do index.html, antes de qualquer outro script.
  2. Não carregue o consent.js de dentro de um componente: ele precisa rodar antes das tags.
  3. Link de preferências: um botão que chama window.AccessConsent?.open().
<script src="https://consent.accesssecurity.com.br/consent.js" data-site="CHAVE-DO-SITE" async></script>
  • Em SPA, a decisão vale para toda a navegação: não é preciso recarregar o script a cada rota.

Google Tag Manager

Modelo de tag do Access Consent com o acionador Consent Initialization – All Pages.

Onde: Contêiner do GTM (tag do modelo Access Consent).

No painel, Sites → seu site → Instalação → Baixar modelo do GTM.

  1. Baixe o modelo do GTM (botão nesta aba) e, no Google Tag Manager, vá em Modelos → Modelos de tag → Novo → ⋮ → Importar e salve.
  2. Em Tags → Nova, escolha o modelo Access Consent (LGPD) e preencha a Chave do site (CHAVE-DO-SITE).
  3. Acionador: Consent Initialization – All Pages. Salve e publique o contêiner.
  • Tags que não são do Google: use o acionador Evento personalizado access_consent_update com a variável access_consent.marketing (ou .analytics) igual a true.
  • Pelo GTM, o bloqueio automático só alcança o que entra depois do script. Para segurar tags escritas no HTML, use o script direto no <head>.

Mais detalhes: Google Tag Manager.

Atualizado em 18/10/2026. Dúvidas: [email protected].