Skip to content

[00] Subset Opt-Out, User guide

Getting started

Install Subset Opt-Out, add a Your Privacy Choices link, and stop ad trackers for visitors who opt out or send Global Privacy Control.

Subset Opt-Out helps you honour opt-out requests under US state privacy laws. Your scripts load as usual. When a visitor opts out, or their browser sends Global Privacy Control (GPC), the plugin stops your ad trackers for them. This page takes you from install to a working setup in about five minutes.

Subset Opt-Out is a tool, not legal advice. Using it doesn’t make your site compliant with any law on its own, so check with a lawyer about what your site needs.

Install

  1. Download the free Subset Opt-Out zip from subsetwp.com/download/opt-out.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
  3. Click Activate. On a multisite network you can activate it network-wide.

You’ll find the settings under Subset → Opt-Out. It needs WordPress 6.5 and PHP 8.1 or later.

Set it up

The settings screen opens with three steps at the top. The other settings already have working defaults.

  1. In 1. Services, click Scan home page. The scan loads your home page once and lists the known trackers it finds. It changes nothing.
  2. In 2. Privacy choices link, tick Add the link to the footer of every page.
  3. Click Save changes.

That’s it. A visitor who clicks the link gets a preferences panel with one switch, labelled Allow sale/sharing of my personal information for targeted ads. Turning it off opts them out.

How opting out works

Scripts run for everyone until a visitor opts out. After that, the plugin holds back the services you’ve left on in Services to stop after an opt-out, deletes their first-party cookies and tells each vendor’s own consent API to revoke.

If a visitor’s browser sends GPC and they haven’t made a choice, the plugin treats them as opted out from their first page view. You don’t need to set anything up for this.

By default an opt-out stops advertising (the marketing category) only. To stop analytics too, tick Opt-out also covers analytics in 5. What an opt-out covers.

Services

Subset Opt-Out knows these ad trackers out of the box:

  • Meta Pixel
  • TikTok Pixel
  • Google Ads conversion and remarketing
  • LinkedIn Insight Tag
  • Pinterest Tag
  • X (Twitter) Pixel
  • Microsoft Advertising UET (Bing)
  • Snap Pixel

Leave on the ones your site uses. If the scan finds a service you’ve switched off, the screen warns you that it will keep running after an opt-out. While PixelYourSite is active, a PixelYourSite service is added to the list too.

For a tracker that isn’t on the list, add a custom rule under Custom blocking rules. A rule matches a script handle, part of a script’s URL or a keyword in inline code, and puts it in the statistics or marketing category. You can add up to 100 rules.

If you’d rather not use the automatic footer link, you can place it in any of these ways:

  • Add the Privacy Choices Link block in the editor.
  • Use the shortcode [subset_cm_privacy_choices].
  • Add the Privacy Choices link to a menu from Appearance → Menus.

The default link text is “Your Privacy Choices”, shown with the California opt-out icon. You can change the text under Link text, or turn off the icon with Show the California opt-out icon after the link text.

Notice bar and colours

In 3. Notice bar and colors, tick Show a small notice bar at the bottom of the page to tell visitors about their choice. The bar shows until the visitor dismisses it, and never shows to visitors whose browser sends GPC. You can set the notice text and the colours of the bar and the preferences panel. The screen warns you if a colour pair is hard to read.

Privacy policy

Pick your privacy policy page in 4. Privacy policy page so the preferences panel can link to it. Subset Opt-Out also adds suggested text to Settings → Privacy → Policy Guide. Treat it as a starting point and edit it to fit your site.

Google tags

Subset Opt-Out doesn’t block Google Analytics, Google Ads or Tag Manager. It sends them Google Consent Mode v2 signals instead. Every visitor starts with ad and analytics storage granted, and a visitor who opts out is switched to denied before any Google tag reads their consent. This works with gtag.js, Google Tag Manager and Site Kit by Google. To gate tags in a container that aren’t Google’s, see Google Tag Manager.

The settings are in 6. Google Consent Mode. Send Consent Mode signals to Google tags turns it on, and Redact ad click identifiers while ad storage is denied is recommended.

Caching and optimisation plugins

Subset Opt-Out prints the same HTML for every visitor, and the browser applies each visitor’s choice. Page caching keeps working.

It also tells WP Rocket, LiteSpeed Cache, Autoptimize, Perfmatters, SiteGround Speed Optimizer and Cloudflare Rocket Loader to leave its scripts alone, with no setup from you. Each page lists what Subset Opt-Out excludes and when to clear the cache. Two things are still yours to check:

  • A tracking script printed before wp_head, or moved above it by an optimiser, runs before Subset Opt-Out can act on it. Move it below wp_head() or hold it with a custom rule.
  • After you change an optimiser’s JavaScript settings, clear its cache and test your site as an opted-out visitor, or with GPC turned on in your browser.

What Subset Opt-Out stores

One first-party cookie, subset_cm_consent, in the visitor’s browser. It records their choice for 12 months. Nothing about visitors is stored in your database. (Pro’s opt-out log changes that if you turn it on.)

Move settings between sites

Under Export and import, click Download settings (JSON) to save every setting, including custom rules. Import that file on another site to copy the setup. You can do the same from WP-CLI: see the developer reference.

Pro

Subset Opt-Out Pro is a separate add-on that needs the free plugin. It adds:

  • Opt-in mode, a consent banner with Accept all, Reject all and Customize at equal weight. Nothing optional runs until a visitor accepts. Turn it on for every visitor if your site handles sensitive data, or only for visitors in regions you choose, such as the EU/EEA, the UK, Switzerland or any other country.
  • State-aware behaviour, which shows the link and notice bar only to visitors in the US states you select.
  • An opt-out request log, off by default, which records when opt-outs happened with a hashed visitor code. You set how long records are kept and can export them as CSV.

Pro’s settings appear as extra tabs on Subset → Opt-Out: Regions, Opt-out log and License.

To set up Pro, install the free plugin first, then upload and activate the Pro zip the same way. Enter your licence key on the License tab and click Activate license. An active licence gets you updates and support.

Visitor location comes from headers your host or CDN adds, such as Cloudflare, CloudFront or Vercel. Subset Opt-Out makes no third-party lookup. If no location header is found, the Regions tab tells you. A visitor whose location can’t be told is asked first under regional opt-in mode.

Get help

Report bugs and request features at Subset feedback on GitHub (opens in a new tab). For anything else, email hello@subsetwp.com.