Open the editor from Shield > Consent: click a setup's title or its Edit icon, or New Consent Setup. Every change goes to the hosted preview when you click Save & Publish Preview, and to your live sites only when you use Publish Live on the Consent list. See Create a Consent Banner.
General
| Field | Default | What it does |
|---|---|---|
| Title | Consent Banner | Required. Names the setup in TagPipes. Visitors never see it. Up to 200 characters |
| Company Display Name | The company name | Shown in the preference center header. Also replaces {company} in the intro paragraphs |
| Company Logo URL | Empty | Logo for the preference center |
| Consent Cookie Domain | Empty (auto-detect) | Bare domain, such as example.com, that stores the decision so it is shared by every subdomain. Also the domain the cookie scanner crawls |
| Linked Domains (Cross-Domain Consent) | Empty | Other domains, one per line, that share one decision. When a visitor follows a link from one listed domain to another, the decision travels with them instead of prompting again. Install the same setup on every domain listed |
| Enabled | On | Master switch for the setup |
Consent Model
| Field | Default | What it does |
|---|---|---|
| Model | Automatic by location | Automatic by location: opt-out banner for US visitors, opt-in banner for EU and UK visitors, plus any Region Rules. Always opt-in: the opt-in banner for every visitor. Always opt-out: the opt-out banner for every visitor |
| Treat all US visitors the same | On | One opt-out experience for every US visitor. Per-state targeting is not available yet |
| Visitors outside covered regions | No banner | What visitors outside the built-in and rule-covered regions get: No banner or Show the opt-out banner anyway |
| Opt-out visitors see only the opt-out switch | Off | When on, the preference center for opt-out visitors shows only the "Opt out of personalized advertising" switch, with no category toggles. Opt-in visitors always see the full category list |
| Opt-in consent expiry (months) | 12 | Opt-in visitors are asked again after this long. 1 to 24 |
| Consent version | 1 | Raise it to discard every stored decision and ask all visitors again, for example after a policy change or a new category. 1 to 9999 |
Region Rules (Advanced)
Rules override the built-in location behavior for specific places. They apply in Automatic by location only, are checked top to bottom, and the first match wins. Click Add Rule to add one; use the arrows to reorder.
| Column | What it takes |
|---|---|
| Countries | ISO country codes, comma-separated, such as CA or BR. Blank matches any country |
| Regions | Region codes such as QC or a US state. Blank matches all regions of the country |
| Behavior | Opt-in (consent first), Opt-out (US style) or No banner |
| Lock (always active) | Category keys that are always active in that place |
| Unlock (needs consent) | Category keys that need consent in that place, even if locked elsewhere |
Example: Countries CA, Regions QC, Behavior Opt-in (consent first) shows the opt-in banner to visitors in Quebec and leaves the rest of Canada on the built-in behavior.
Theme
| Field | Default | What it does |
|---|---|---|
| Banner layout | Full-width bar (bottom) | Also Floating box (bottom left) or Floating box (bottom right) |
| Corner radius (px) | 6 | 0 to 24 |
| Accent (buttons) | Empty (built-in color) | Button color, as a hex value such as #549ccc |
| Background | Empty (built-in color) | Banner and preference center background |
| Text | Empty (built-in color) | Text color |
Floating Privacy Badge
A small "Your Privacy Choices" button in a page corner that reopens the preference center. It appears after the visitor has dealt with the banner, uses the theme colors, and its label is the preference center Title.
| Field | Default | What it does |
|---|---|---|
| Show the floating badge | On | Turn off only when every page already carries its own link that reopens the preference center |
| Include a privacy request (DSAR) link | Off | Clicking the badge opens a small menu with a second entry that links to the Privacy Request (DSAR) Form URL. No effect while that URL is blank |
| Corner | Bottom left | Or Bottom right |
| Style | Pill - icon + text (recommended) | Or Icon only. Icon only shows no text label |
Google Consent Mode
| Field | Default | What it does |
|---|---|---|
| Emit Consent Mode v2 signals | On | Sets consent defaults before any Google tag fires and updates them when the visitor chooses. Leave on unless the site runs no Google tags |
| Ads data redaction | On | When ad storage is denied, strips ad click identifiers such as gclid from Google requests |
| URL passthrough | Off | Passes ad click information through page URLs when cookies are denied |
| Wait for update (ms) | 500 | How long Google tags wait for the consent state before firing with defaults. 0 to 10000 |
Which signals each category grants is set in Consent Categories.
Privacy Signals (GPC / DNT)
| Field | Default | What it does |
|---|---|---|
| Honor Global Privacy Control (GPC) for opt-out visitors | Always on | A browser that sends GPC is opted out of personalized advertising automatically, with no banner interaction. Cannot be turned off |
| Apply GPC to opt-in (EU) visitors as Reject All | Off | A GPC browser in opt-in mode gets Reject All applied automatically |
| Send consent_changed events to Echo | Off | When a visitor grants, changes or withdraws consent, sends a consent_changed event into Echo. Requires an Echo source for consent events |
| Honor legacy Do Not Track (DNT) | Off | When on, a DNT browser is treated exactly like a GPC browser |
Banner Messages
English text. Translations go in Languages.
| Field | Default |
|---|---|
| Opt-out banner message (US style) | "We and our advertising partners use cookies and similar technologies to personalize the ads you see. You can opt out of personalized advertising at any time." Up to 2,000 characters |
| Opt-out link text | "Do Not Sell or Share My Personal Information" |
| Opt-in banner message (EU style) | "We would like your consent to use cookies and similar technologies for analytics and advertising. Nothing optional runs until you choose." Up to 2,000 characters |
Preference Center Text
Blank fields use the built-in wording, shown as the placeholder. The paragraph fields accept a little HTML (<a href="...">, <b>, <i>, <br>); titles and link labels are plain text. Use {company} in the intro paragraphs to insert the company display name.
| Field | Built-in text |
|---|---|
| Title (also the banner's privacy link) | Your Privacy Choices |
| Opt-out switch title | Opt out of personalized advertising |
| Intro paragraph (opt-out visitors) | {company} respects your privacy. Use the controls below to opt out of personalized advertising and manage cookie categories. Your choices apply to this browser on this device. |
| Intro paragraph (opt-in visitors) | {company} asks for your consent before using any optional cookies. Optional categories stay off until you turn them on, and you can withdraw consent at any time. |
| Opt-out switch description | Turns off personalized advertising and limits the personal information shared with our advertising partners. |
| Rights paragraph | Your other privacy rights. You can request access to, deletion of, or correction of your personal information. |
| Non-discrimination sentence | You will not be discriminated against for exercising your rights. |
| Privacy request link label | Submit a privacy request |
| Privacy policy link label | Privacy Policy |
Links
| Field | What it does |
|---|---|
| Privacy Policy URL | Linked from the preference center |
| Privacy Request (DSAR) Form URL | Your published Shield intake form. Linked from "Submit a privacy request" and, if enabled, from the floating badge |
Consent Categories
The toggles visitors see, in the order listed. Use the arrows to reorder, Add Category to add one, and the x to remove one. Up to 20 categories.
| Column | What it does |
|---|---|
| Key | Stable code the visitor's choice is stored against. Lowercase letters, digits and underscores. Do not change a key after going live. A locked category's key cannot be edited and the category cannot be removed |
| Label | Name visitors see |
| Description | Text visitors see under the label |
| Google Signals | Which Consent Mode signals the category grants: None, Ad signals, Analytics, Functional or Security (essential) |
| Locked | Always active; visitors cannot switch it off. At least one category must be locked |
Default categories:
| Key | Label | Google Signals | Locked |
|---|---|---|---|
essential | Strictly Necessary | Security (essential) | Yes |
analytics | Analytics | Analytics | No |
advertising | Marketing | Ad signals | No |
functional | Functional | Functional | No |
Categories that grant Ad signals are the ones the opt-out of personalized advertising switches off, whatever the category is called.
Languages
The banner detects the visitor's browser language. Buttons and headings are translated automatically. To translate your own text, pick a language and click Add Language: German, French, Spanish, Italian, Dutch, Portuguese, Polish, Swedish or Danish. Each language card has Opt-out banner message, Opt-out link text, Opt-in banner message and Category translations. Blank fields fall back to English.
Custom CSS (Advanced)
CSS that restyles the banner and preference center. It is applied inside the widget only, so it cannot affect the rest of your page, and your page's styles cannot affect the widget. CSS only, no HTML tags, up to 20,000 characters.
Right-hand panels
| Panel | What it shows |
|---|---|
| Live Banner Preview | A quick sketch of the banner. The full interactive preview is built when you save |
| Publish Status | Status, Preview updated, Live since, Consent version, any publish Error, and the Hosted preview and Config JSON (SDK contract) links |
| Install On Your Site | The install snippets. See Install the Consent Banner |
| Cookie List For Your Privacy Policy | The embed snippet for your cookie table. See Cookies and Storage |
TagPipes monitors, configures and reports. It does not determine legal compliance and does not provide legal advice. Output is informational and reflects observed state at the time of observation. Confirm any regulatory interpretation with your counsel.