How to Share Consent Across Subdomains with Cross-Domain Consent

Edited

By default, each domain and subdomain that you add to Captain Compliance keeps its own consent record. A visitor who chooses on www.example.com is asked again on shop.example.com. Cross-domain consent links subdomains to their root domain, so that one choice can carry across them. This article explains the options, how to set them up, and what to consider first.

How it works

  • Linked domains share one consent cookie. It is set on the root domain, for example .example.com, where every subdomain can read it.

  • Only subdomains of the same root domain can be linked. Two different domains, such as example.com and example.org, cannot share consent this way, because browsers do not let one site read another site’s cookies.

  • Each domain keeps its own script, banner configurations, and cookie list.

The three options

Option

What happens

Not linked (default)

Each domain asks on its own and stores its own choice.

One-way from primary

The root domain is the primary. A choice made there is shared, so the visitor is not asked again on linked subdomains. A choice made on a subdomain is kept for that subdomain only. It does not change the choice on the primary or on other subdomains.

Two-way within domain family

Any linked domain can update the shared choice. A choice made on one applies on all of them.

Before you start

Link subdomains

  1. In the Captain Compliance app, select Scans in the sidebar.

  2. On the root domain’s card, select the Cross-Domain icon, which looks like a paperclip.

  3. Under Subdomains, select each subdomain that should share consent with the root domain.

  4. Under Consent direction, select One-way from primary or Two-way within domain family.

  5. Select Save changes.

The Cross-domain consent dialog:

The Cross-domain consent dialog, with the subdomain shop.example.com selected and the two consent direction options, One-way from primary and Two-way within domain family

If the dialog says No domains to link, scan a subdomain of this domain first. To stop sharing, open the dialog again, clear the subdomain’s checkbox, and confirm. Allow about a minute for a change to reach the live banner.

What to consider

Sharing consent is a legal choice as well as a technical one.

  • Share only between sites that one organization runs for the same purposes. A visitor who allows analytics on a help site has not necessarily agreed to advertising cookies in a store.

  • Consent should be informed. If a subdomain uses vendors that the primary does not, a shared Allow may not cover them. Make sure that the banner text and the cookie transparency page describe the cookies used across all linked sites.

  • Opt-outs should travel at least as far as opt-ins. Under U.S. opt-out laws, a request to stop selling or sharing applies to the business, not to one web address. With one-way sharing, an opt-out made on a subdomain stays on that subdomain. Two-way sharing carries it to every linked site.

  • Use the same consent model for a region on every linked domain. Otherwise a choice made under one model is applied under another.

  • Tell visitors. Say in the banner or the privacy notice that the choice applies across your sites.

This article describes product behavior and common considerations. It is not legal advice. Confirm your approach with your own counsel.

Check the result

  1. Open the root domain in a private or incognito browser window, and make a choice in the banner.

  2. Open a linked subdomain in the same window. The banner should not appear again.

  3. With two-way sharing, repeat the test in the other direction. With one-way sharing, confirm that a choice made on the subdomain does not change the root domain.

  4. In the browser’s developer tools, look for the cc_global_consent cookie. Its domain should be the root domain with a leading dot.

For more detail, add ?cc_debug=true to the page address. The console then shows how the banner resolved the shared choice. See How to Troubleshoot a Consent Banner That Does Not Appear or Respond.

Related articles