Localize the banner and honor GPC
By OptinStack Team - Jun 28, 2026 - 2 min read
OptinStack stores one published banner language on the site config, can fetch translated banner strings and tracker-purpose text on eligible plans when the active page language is non-English, and can honor the Global Privacy Control signal sent by the visitor's browser. This article covers how the runtime picks a language, when translation requests happen, and how GPC changes consent defaults.
Choose the default banner language
The published site config stores one default language in presentation.locale.lang. The runtime resolves the active banner language from the page html lang first and falls back to the configured language when html lang is missing.
Translation fetches only happen for a resolved non-English language. The runtime normalizes locale variants to their primary language, so fr-CA requests fr. If the resolved language is English, no translation request is made even when the configured fallback differs.
Business and Enterprise hostnames can publish a non-English default language and use CDN translations for banner strings and tracker-purpose text. Free and Pro stay English-only on development and custom hostnames; the platform never elevates a hostname beyond its assigned tier.
Honor Global Privacy Control
Respect GPC signal is on by default. When it stays enabled and navigator.globalPrivacyControl is true, the runtime marks GPC as active, includes gpc: true in consent sync payloads, and adjusts optional consent defaults before the banner UI renders.
The default GPC behavior is reject-all, which sets analytics, marketing, and preferences to false. Business and Enterprise projects can switch GPC behavior to custom. In custom mode, only the selected optional categories are forced to false, and any optional category not selected keeps the normal banner-mode default.
Non-English banner languages, automatic translation fetches, and custom GPC category behavior require Business or Enterprise. GPC itself is still honored on lower tiers while Respect GPC signal remains enabled.
Related articles
Banner modes: opt-in, opt-out, informational, dont-sell
The four banner modes (opt-in, opt-out, informational, dont-sell) and when to use each, including the GPC interaction.
CCPA/CPRA and US state privacy
How OptinStack supports CCPA/CPRA and US state opt-out and do-not-sell flows, including GPC as a valid signal.
Set up Google Consent Mode v2
Map OptinStack's four consent categories onto Google Consent Mode v2 and keep them in sync as visitors choose.
How visitor consent is stored and re-asked
How visitor consent is stored locally and synced to the server, when the banner re-asks, and how consent expires.
How helpful was this article?