Setup guide · version 1.1.0

Launch safely in eight steps.

Before you start: ConsentGuard Pro costs $29/month per sub-account, with a 7-day free trial. It requests no OAuth scopes. A paid app installs only on a business account that has a payment method on file; accounts without one are skipped and the app does not appear. Add the payment method first, then install.

1. Install. Open the install link for ConsentGuard Pro, choose the business account, review the permissions and click Allow & install. ConsentGuard Pro requests no OAuth scopes.

   

2. Open your page. In the business account go to Sites > Funnels (or Websites), open the funnel or site and click Edit on the page.

   

3. Open the Add elements panel. In the page builder click the + button at the top left.

   

4. Find the widget. Go to + Add elements > Widget Marketplace > Installed. ConsentGuard Pro (category: Security & Privacy Tools) is listed there. It is not in the Elements list; you add it from this panel.

   

5. Add it to the page. Drag the ConsentGuard Pro card onto a section of the page. A Web Widget element appears and its settings window opens. The editor shows a small Cookie banner is on card for the element. The banner itself appears on the preview and on the published page.

   

6. Configure in the five tabs. The settings window has five tabs. Change only what the site needs.
   • Look: starting point (Balanced, Strict or Compact), the three colors, light, dark or automatic scheme (Auto follows each visitor's device setting), banner shape, banner position and the reopen button position.
   • Text: business name, headline, message, privacy-policy and contact links (full https:// addresses), an optional logo image link, the main language, browser-language matching and the languages to offer: English, Spanish, French, German, Italian, Dutch and Portuguese.
   • Privacy: the analytics, advertising and functionality categories, the reject button, following the browser's Global Privacy Control signal, clearing known analytics and advertising cookies when they are not allowed, the visitor consent record and the local audit trail.
   • Tracking: Pause tracking scripts until allowed, the Load button for videos and maps, the services on your site (ten services in three groups: Analytics, Advertising, Videos and maps), and Google signals (Consent Mode v2).
   • Advanced: cookie domain, how many days a choice lasts, the policy revision, copy settings JSON, and reset to defaults.
   Fields with a problem show an inline message and are not applied. A tab badge shows how many items need a look.

   

   

   

   

7. Apply to page and save. Click Apply to page, then save the page in the builder. To change the settings later, select the Web Widget element and click the gear icon on its toolbar, adjust, click Apply to page again and save.
8. Publish and test. Publish the page to your domain, or open the page preview link shown under the toolbar. In a private browser window, test Accept all, Reject optional, the granular preferences and the Privacy settings button. Optional storage starts denied and changes to granted only after the visitor accepts.

   

Block a script until consent

To hold a tracking tag until the visitor allows its category, first turn on Pause tracking scripts until allowed in the Tracking tab and enable the matching service under Services on your site. Then mark the tag like this:

<script type="text/plain" data-category="analytics" data-service="ga4">…</script>

The tag runs after the visitor allows the category or service. After a rejection it stays off. For advertising or functionality tags, use data-category="advertising" or data-category="functionality" and the matching service id.

Video and map placeholder

To keep an embedded video or map off until the visitor allows it, turn on Show a Load button for videos and maps in the Tracking tab and use an iframe with data-cg-src instead of src:

<iframe data-cg-src="https://www.youtube-nocookie.com/embed/VIDEO_ID" data-service="youtube" title="…"></iframe>

The visitor sees a small card with a Load video button (or Load map for maps). The iframe gets its real source only after the visitor clicks it and accepts that service. Replace VIDEO_ID with your video ID, keep a descriptive title, and use data-service="vimeo" or data-service="google-maps" for those embeds. Only https sources are accepted.

Cookie settings link

Add a footer link so visitors can change their choice at any time:

<a href="#cookie-settings">Cookie settings</a>

Consent Mode v2 and consent signals

When Consent Mode is on, ConsentGuard Pro writes default-denied Google consent signals before a choice is made, and sends an update after the visitor chooses. It also sends consent signals to Meta, TikTok, Microsoft UET and Clarity, and fires a consentguard_update event in the dataLayer. Confirm that tags on the page honor these signals; the widget cannot correct unrelated tag configuration.

Browser privacy signal

When Follow the browser's privacy signal is on in the Privacy tab and the visitor's browser sends Global Privacy Control, optional cookies start off and the banner stays hidden. The preferences still open from the reopen button or a Cookie settings link, and the visitor sees that the signal was applied.

Visitor consent record

The widget keeps the last 20 choices in the visitor's browser, with the time, policy revision, categories and language. The visitor can download the record as a JSON file from the preferences window. Nothing is sent to your server or to DAHMANI LIMITED.

Policy revisions

Increase the revision only when a policy or category change requires visitors to choose again. Changing it causes a new prompt.

Uninstall

Remove the widget from the page and republish. Confirm the ConsentGuard interface and runtime are absent. Existing first-party browser storage can be cleared by the visitor or by normal site-data controls.

ConsentGuard Pro is a technical consent tool. It helps you show a consent choice and connect it to your tags, but it does not replace professional advice on your own obligations. Need help? Email mohammed@dahmani.me. Include the browser, page type, selected preset, and exact visible error. Never send passwords or access tokens.