Guía de instalación para Next.js
Añade Velo a Next.js
Instala el banner de cookies de Velo y Google Consent Mode v2 en Next.js con una línea en tu layout raíz. Con acceso al código de la web, la mayoría de las instalaciones llevan unos minutos. Si usas Google Tag Manager, esta página también explica esa vía.
Instrucciones y fuentes de las imágenes revisadas el 7 de noviembre de 2026.
Qué necesitas en Next.js
Antes de empezar
- Dónde. app/layout.tsx → head
- Plan. App Router o Pages Router
- Se activa. Tras tu próximo despliegue
- Tiempo habitual. Unos cinco minutos
Cuando ya está en marcha
- Tu banner sigue los valores por defecto que has fijado para la región de cada visitante.
- Las etiquetas esperan hasta que el visitante ha elegido.
- Cada elección queda registrada, y Consent Mode v2 se la pasa a tus etiquetas de Google.
Dos formas de instalar Velo en Next.js
Elige la vía que encaje con la forma en que tu web ya carga sus etiquetas. Las dos acaban con el mismo banner y las mismas señales.
Pega una línea en tu layout raíz
Añade el fragmento de tu web al head de todas las páginas, publica y pruébalo en la web en producción. Si tus etiquetas de medición ya van por Google Tag Manager, usa mejor la vía que tienes más abajo.
¿Usas Tag Manager? Olvídate del código
Si ya tienes Google Tag Manager en tu web, esta es la forma más fácil de añadir Velo. No tienes que tocar código, son cuatro pasos cortos y todas tus etiquetas quedan en un solo sitio.
Carga el fragmento una sola vez, desde el layout raíz. Una etiqueta en un useEffect se ejecuta cuando tus otras etiquetas ya pueden dispararse, y next/script sin estrategia espera a la hidratación. Prueba una página a la que llegues con un Link, además de una recarga completa. El banner debe seguir ahí, sin una segunda copia.
Todo lo que necesita una configuración de consentimiento
El mismo banner, los mismos registros y los mismos análisis en todos los planes. Pro añade webs ilimitadas, análisis ilimitados y tu propio logo.
Tu banner pregunta en el idioma del visitante y sigue los valores por defecto que has fijado para su región.
Cada elección queda registrada, y Consent Mode v2 se la pasa a tus etiquetas de Google.
Pega una línea en tu layout raíz
Añade el fragmento de tu web al head de todas las páginas, publica y pruébalo en la web en producción. Si tus etiquetas de medición ya van por Google Tag Manager, usa mejor la vía que tienes más abajo.
Copia la línea
Copia desde tu panel de Velo el fragmento de instalación completo de esta web. El ejemplo de abajo solo muestra el formato: sustituye your-site-id antes de usarlo. Deja el endpoint de la API tal como te lo da el panel.
<script src="https://cdn.veloconsent.com/v1/velo.js" data-api="https://app-staging.veloconsent.com" data-velo-site="your-site-id" async></script>
Pégala en tu layout raíz
Con el App Router, abre el layout raíz (app/layout.tsx o src/app/layout.tsx). Si no tiene un elemento <head>, añade uno encima de <body> y pega dentro tu fragmento completo de Velo, encima de cualquier etiqueta de analítica o publicidad. Con el Pages Router, pégalo dentro de <Head> en pages/_document.tsx, y crea ese archivo si el proyecto no lo tiene. El fragmento es JSX válido tal como está. No lo pongas en un useEffect ni en next/script con la estrategia por defecto, porque ambos lo cargan cuando tus otras etiquetas ya pueden dispararse. Despliega y prueba una página a la que llegues con un Link, además de una recarga completa.
// app/layout.tsx on the App Router. On the Pages Router, the same
// line goes inside <Head> in pages/_document.tsx.
export default function RootLayout({ children }) {
return (
<html lang="en">
<head>
{/* Paste the complete Velo snippet from your dashboard here. */}
<script src="https://cdn.veloconsent.com/v1/velo.js"
data-api="https://app-staging.veloconsent.com"
data-velo-site="your-site-id" async></script>
</head>
<body>{children}</body>
</html>
);
}Publica y compruébalo en producción
Guarda y publica el cambio siguiendo los pasos de tu plataforma que tienes arriba, y vacía la caché de la web o del CDN. Abre la URL publicada en una sesión nueva del navegador. Comprueba que el banner aparece donde lo exigen tus reglas por región, prueba a aceptar y a rechazar, y verifica que los valores por defecto y las actualizaciones del consentimiento se aplican antes de que se ejecuten tus etiquetas de medición. Confirma que tu web aparece como instalada en el panel de Velo.
El banner de Velo con su aspecto por defecto. El texto, los colores y los ajustes por región de tu banner pueden ser distintos.¿Usas Tag Manager? Olvídate del código
Si ya tienes Google Tag Manager en tu web, esta es la forma más fácil de añadir Velo. No tienes que tocar código, son cuatro pasos cortos y todas tus etiquetas quedan en un solo sitio.
La guía completa de Tag ManagerAñade Velo a Tag Manager
Abre la plantilla de Velo, pulsa Add to workspace y elige tu contenedor. Abrir la plantilla de Velo ↗
Pega el ID de tu web
En Tag Manager, abre Tags y pulsa New. Pulsa Tag Configuration, elige Velo CMP y pega el ID de tu web. Lo encontrarás en tu panel de Velo. Deja todo lo demás como está.
Haz que cargue primero
Pulsa Triggering, elige Consent Initialization – All Pages y pulsa Save. Así Velo arranca antes que tus otras etiquetas.
Publica y compruébalo
Pulsa Submit y luego Publish. Preview no basta para poner Velo en marcha. Después abre tu web en una ventana privada, prueba el banner y comprueba que tu web aparece como instalada en tu panel de Velo.
O deja que lo haga un agente
Copia el prompt y pégalo en Claude, ChatGPT, Cursor o el asistente que ya uses. Lleva todo lo que hay en esta página: las dos vías, el orden en que tienen que cargar las etiquetas y las comprobaciones que demuestran que funciona.
Instalar con IAEl prompt
Pega este prompt en tu asistente y pásale el ID de tu web y, desde tu panel de Velo, el fragmento de instalación completo o los ajustes de GTM.
Instala Velo en Next.js. Guía actual: https://veloconsent.com/nextjs Antes de tocar nada, consigue en el panel de Velo el ID de mi web y el fragmento de instalación completo, o la configuración de GTM. Comprueba qué herramienta de consentimiento y qué etiquetas de medición hay ya en la web. Elige una sola vía de instalación: A. Si la web ya usa Google Tag Manager, añade la plantilla Velo CMP (publicada por veloconsent) desde la Community Template Gallery. Configura el ID de mi web, el tema y el endpoint de la API con los datos del panel. Revisa las opciones avanzadas: ads_data_redaction y url_passthrough vienen desactivadas por defecto. Usa el activador Consent Initialization – All Pages y comprueba el consentimiento en Preview antes de publicar. Pasos completos: https://veloconsent.com/google-tag-manager B. Instalación directa: Con el App Router, abre el layout raíz, app/layout.tsx o src/app/layout.tsx, añade un elemento <head> encima de <body> si no lo hay y pega dentro tu fragmento completo de Velo, encima de cualquier etiqueta de analítica o publicidad. Con el Pages Router, pégalo dentro de <Head> en pages/_document.tsx, y crea ese archivo si el proyecto no lo tiene. El fragmento es JSX válido tal como está. No lo cargues desde useEffect ni con next/script con la estrategia por defecto: ambos lo cargan cuando tus otras etiquetas ya pueden dispararse. Despliega y prueba una página a la que llegues con un Link, además de una recarga completa. Respeta el código que no tenga que ver con Velo. No instales Velo dos veces ni dejes valores de consentimiento por defecto que choquen entre sí. No des por hecho que ponerlo en el head o cargarlo en async garantiza por sí solo el orden de las etiquetas. Revisa la web publicada en una sesión nueva. Comprueba el banner según las reglas por región configuradas, los valores de consentimiento iniciales, las actualizaciones al aceptar y al rechazar, y el evento velo_consent_update. Comprueba que las etiquetas que no son de Google siguen las categorías que tienen asignadas. Prueba una segunda página y cualquier checkout que vaya por separado. Confirma que las señales llegan al panel de Velo. Cuéntame qué has cambiado, dónde y qué ha dado cada comprobación. Dime si te ha faltado algún acceso o si hay alguna comprobación que no hayas podido hacer.
Del blog
Notas sobre banners de cookies, Consent Mode y los datos que se pierden entre medias.
¿Necesitan las webs canadienses Consent Mode v2?
Google Consent Mode v2 en Velo: novedades
Cómo configurar Google Consent Mode v2 en Shopify
Preguntas frecuentes sobre Velo en Next.js
¿Funciona con el App Router y con el Pages Router?
Sí. El App Router lleva el fragmento en el layout raíz y el Pages Router en pages/_document.tsx. Hemos probado los dos en Next.js 16, con recargas completas y con navegación por Link.
¿Debería usar next/script?
Solo con strategy="beforeInteractive" en el layout raíz, que también funcionó en nuestras pruebas. Una etiqueta normal es más sencilla, porque está en el HTML desde el primer byte, mientras que beforeInteractive lo arranca el propio cargador de Next.js. Evita afterInteractive, el valor por defecto, y lazyOnload, que cargan cuando tus otras etiquetas ya pueden dispararse.
¿El banner se mantiene en la navegación del lado del cliente?
Sí. La navegación por Link mantiene el mismo documento, así que el banner, el botón que lo vuelve a abrir y la elección del visitante siguen en su sitio, y la etiqueta del layout no se vuelve a cargar.
Mi web define una Content Security Policy.
El fragmento necesita https://cdn.veloconsent.com en script-src y https://app-staging.veloconsent.com en connect-src. Revisa la consola del navegador después de publicar y permite cualquier otra cosa que bloquee tu política.
¿Ralentizará mi web?
El fragmento del panel carga de forma asíncrona. Como con cualquier script, mide cómo afecta a tu web y revisa el orden de las etiquetas: la carga asíncrona, por sí sola, no garantiza que los valores de consentimiento por defecto se apliquen antes que el resto de etiquetas.
¿Puede hacerlo por mí un asistente de IA?
Sí. Copia el prompt de Instalar con agentes, justo debajo, y pégalo en Claude, ChatGPT, Cursor o el asistente que ya uses. Incluye los pasos de esta página, el orden en que tienen que cargar las etiquetas y las comprobaciones que el agente tiene que hacer antes de darte el trabajo por terminado.
Gratis para una web
Banner, análisis y registros de consentimiento para una web, gratis. Pro desde €7 al mes, más IVA, para webs ilimitadas.