Skip to main content

Add ConsentForge to Next.js

Use Next.js's <Script> component with strategy="beforeInteractive" to ensure ConsentForge loads before any other scripts:

// app/layout.tsx (App Router) or pages/_document.tsx (Pages Router)
import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html>
      <head>
        <Script
          src="https://cdn.consentforge.com/consentforge.min.js"
          data-token={process.env.NEXT_PUBLIC_CONSENTFORGE_TOKEN}
          strategy="beforeInteractive"
        />
      </head>
      <body>{children}</body>
    </html>
  )
}

Option 2: _document.tsx (Pages Router)​

import { Html, Head, Main, NextScript } from 'next/document'

export default function Document() {
  return (
    <Html>
      <Head>
        <script
          src="https://cdn.consentforge.com/consentforge.min.js"
          data-token={process.env.NEXT_PUBLIC_CONSENTFORGE_TOKEN}
          defer
        />
      </Head>
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  )
}

Blocking third-party scripts​

Use strategy="lazyOnload" for scripts that require consent — they won't load until consent is given and ConsentForge releases them:

<Script
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXX"
  data-consent-category="analytics"
  strategy="lazyOnload"
/>

Environment variables​

Add to .env.local:

NEXT_PUBLIC_CONSENTFORGE_TOKEN=cf_live_your_token_here

TypeScript: ConsentForge window types​

// types/consentforge.d.ts
interface Window {
  ConsentForge: {
    openPreferenceCenter: () => void;
    getConsent: (category: string) => boolean;
    on: (event: string, callback: (data: unknown) => void) => void;
  }
}