Analytics & tracking
Usage
Open Site → Tracking & Privacy and, under Analytics & tracking, paste IDs only for the services you use: Google Analytics, Google Tag Manager, Facebook Pixel, LinkedIn, StackAdapt, Hotjar, HubSpot, Piwik PRO, PostHog, Lead Forensics, and Convert. Leave the rest blank. A field with a value has a green dot beside its label, and each section's link in the side nav counts its filled fields, so you can see what's in use without reading every field. Google, Facebook and Bing verification tags have their own section, Site verification.
These settings used to be in Appearance → Customize → Scripts & Embeds; they moved to their own page, with the same values. You can paste either the ID or the whole code snippet the service gives you: Dirigible keeps just the ID, and the field shows it after you click Save settings. If the value isn't in that service's format (each field's description says what it looks like), that field isn't saved and a red note under it says why; everything else on the page saves. Google Analytics & Ads IDs takes several Google IDs, separated by commas: your Google Analytics ID (G-…) and any Google Ads (AW-…) or other Google tag IDs (GT-, DC-), up to 10. Paste two Google tag snippets and it keeps both IDs, in order. They load together through one Google tag, alongside Google Tag Manager ID if you fill that in too. Every other field takes one ID, so if what you paste has several (two pixels, for example), the message lists them and you paste just the one that field is for. Old Universal Analytics IDs (UA-…) stopped working in 2024, so Google Analytics & Ads IDs asks you to leave them out and keep your GA4 Measurement ID (G-…).
For HubSpot, enter the HubSpot Portal ID (your Hub ID) and set HubSpot Region to EU if your HubSpot tracking code loads from js-eu1.hs-scripts.com. For Piwik PRO, enter both the Piwik PRO Account Address and the Piwik PRO Container ID; tracking stays off until both are filled in.
For PostHog, enter the PostHog Project API Key (it starts with phc_; PostHog shows it under Project settings), or paste PostHog's whole snippet, and set PostHog Region to EU if your snippet says api_host: 'https://eu.i.posthog.com' (the key field asks for just the key when you paste an EU snippet, so you set the region yourself). PostHog then loads with the rest of your tracking: it follows the Cookie banner and the Tracking Load Strategy, and with the banner on, a visitor who declines after accepting has PostHog's ph_ cookies cleared too. The field uses PostHog's own cloud, US or EU. A snippet that sends PostHog through your own address (a proxy api_host) or sets more options than api_host and defaults stays pasted in Custom embeds; with the banner on, turn on Load Pasted Tracking Only After Consent so it waits for consent.
For Lead Forensics, paste the tracking code Lead Forensics gave you into Lead Forensics Tracking Script, or just the script's address from it (https://…/js/ and a number, ending .js; the domain is your account's own and doesn't say Lead Forensics). The field keeps the address. Lead Forensics then loads with the rest of your tracking: it follows the Cookie banner and the Tracking Load Strategy instead of loading before the page is drawn, and still tracks visits and PDF, Word and Excel downloads. Remove the old code from Custom embeds in the same save, or it loads twice. Optimize script delivery doesn't move Lead Forensics code for you.
For Convert A/B tests, enter the Convert Experiences Project ID (two numbers joined by a hyphen, like 10012345-10067890), or paste the tracking code from Convert's Project → Configuration → Tracking code. Convert loads first on every page, before anything else, so tests change the page before visitors see it; Tracking Load Strategy doesn't apply to it. Because it loads before the page shows, it adds to load time on every page, so remove the ID when no tests are running. With the Cookie banner on, tests still show to every visitor, but Convert waits to set its tracking cookies and record visits until the visitor accepts (Convert's own consent mode). The field loads Convert's current tracking script. Code that loads …/js/… instead of …/v1/js/… is Convert's legacy script: switch the project to the current script in Convert first, or keep that code pasted in Custom embeds.
Tracking Load Strategy sets when tracking starts. With First Interaction (the default), a visitor's first page waits until they click, scroll, type or move the mouse, or 5 seconds after the page loads, whichever comes first. That keeps tracking out of speed tests such as PageSpeed Insights. Visitors who arrive from search, another site, an ad or a campaign link are tracked as soon as the page loads, and so is every later page of a visit. The only visits not tracked are ones with no source (a typed address or a bookmark) that leave the first page within those 5 seconds without touching it. After Page Load starts tracking once every page loads, for every visitor. Your own visits while logged in as an admin aren't tracked unless you turn on Track Admin Sessions, which is meant for testing.
With WooCommerce active, Enhanced Ecommerce Tracking sends completed purchases to Google Analytics or Tag Manager. When a Google Tag Manager ID is filled in, these ecommerce events go to Tag Manager only (set up your container to pass them on), even if you also have IDs in Google Analytics & Ads IDs. Ecommerce Debug Mode shows those events in the browser console, for testing only.
When to use it
- Launching a new site and connecting Google Analytics and marketing tags in one place.
- Keeping tracking tags out of PageSpeed Insights scores while still tracking visitors from search, ads and other sites.
- Tracking shop revenue from WooCommerce orders.
Tips
- Turn on the Cookie banner if tracking should wait for visitor consent.
- You don't need both Google IDs and a Tag Manager ID unless your setup calls for it. Follow your analytics team's plan. If your Tag Manager container already loads a Google Analytics or Ads tag, don't also enter that ID under Google Analytics & Ads IDs, or its visits count twice. With both filled in, the Google IDs start before Tag Manager. If your container sets its own consent defaults (a Consent Initialization trigger), use the cookie banner's Consent Mode instead, or put the Google IDs in the container, so the defaults come first.
- Moving HubSpot, Piwik PRO, PostHog or Convert from pasted code to these fields? Remove the old code from Custom embeds in the same save, or it loads twice (every visit counted twice; a pasted PostHog snippet instead runs in place of the field, outside the load strategy and, unless Load Pasted Tracking Only After Consent is on, the cookie banner). The account and its reports carry on as before. Optimize script delivery can do this for you with PostHog's standard snippet. Unlike pasted code, HubSpot, Piwik PRO and PostHog wait for consent when the Cookie banner is on, and Convert runs its tests but waits to set its tracking cookies and send data until visitors accept.
- Convert reads page variables (such as
_conv_page_type) that must be set before it loads. If you paste those in Custom embeds, keep Convert's code pasted after them rather than moving it to the field. - Turn off Track Admin Sessions on the live site so reports show real visitors only.
- The Facebook Pixel ID loads on every page. If your Meta ads point to Dirigible Music link pages, Music can keep the pixel to those pages only: Music → Settings → Ads and analytics.
- After publishing, check in a private window with your provider's debugger that tags are firing.
Settings
Analytics & tracking
Enable analytics and tracking scripts for logged-in administrators. This is useful for debugging and development, but should be disabled in production so that you don't track your own activity.
Off by default.
Your Google Analytics ID (G-XXXXXXXXXX), plus any Google Ads IDs (AW-XXXXXXXXX) or other Google tag IDs (GT-, DC-), separated by commas. You can paste the whole Google tag code. These load alongside a Google Tag Manager ID: leave out any ID your Tag Manager container already loads, or its visits count twice.
Starts with GTM-, like GTM-XXXXXXX. You can paste the whole Tag Manager code.
A 15 or 16 digit number from Meta Events Manager. You can paste the whole pixel code.
A number, like 1234567, from your Insight Tag in LinkedIn Campaign Manager. You can paste the whole Insight Tag code.
Your Universal Pixel ID: the code inside saq('ts', '…') in your StackAdapt pixel, about 22 letters, numbers and dashes. Capitals matter. You can paste the whole pixel code.
Your Hotjar Site ID, a number (hjid in the tracking code). You can paste the whole tracking code.
Your HubSpot Hub ID: the number in your HubSpot tracking code, as in js.hs-scripts.com/1234567.js. You can paste the whole tracking code. When you fill this in, remove the old pasted HubSpot code from Custom Embeds, or visits are counted twice. The HubSpot account and its history stay the same.
Where your HubSpot account is hosted. Choose EU if your tracking code loads from js-eu1.hs-scripts.com.
Your Piwik PRO account name, or its full address (example.piwik.pro or example.containers.piwik.pro). When you fill in this and the Container ID, remove the old pasted Piwik PRO code from Custom Embeds, or visits are counted twice. The Piwik PRO account and its history stay the same.
The site's container ID from Piwik PRO: Administration → Sites & apps → Installation. It looks like 1a2b3c4d-1234-5678-9abc-1a2b3c4d5e6f. You can paste the whole container code.
Your PostHog project API key, phc_ and about 43 letters and numbers, from posthog.init('phc_…') in the snippet (PostHog: Project settings → Project API key). Capitals matter. You can paste the whole snippet. PostHog loads with the other tracking, follows the cookie banner and the Tracking Load Strategy, and uses PostHog's own cloud (US or EU). When you fill this in, remove the old pasted PostHog snippet from Custom embeds: while it's there, PostHog runs from the pasted copy instead of this field, outside the Tracking Load Strategy and, unless Load Pasted Tracking Only After Consent is on, the cookie banner. The PostHog project and its history stay the same.
Where your PostHog project is hosted. Choose EU if your snippet says api_host: 'https://eu.i.posthog.com'.
The address of your Lead Forensics tracking script: the src of the script in the tracking code Lead Forensics gave you, https://…/js/ and a number, ending .js. You can paste the whole tracking code. Lead Forensics then loads with the other tracking and follows the cookie banner and the Tracking Load Strategy. When you fill this in, remove the old pasted Lead Forensics code from Custom embeds, or it loads twice.
Your Convert project ID, two numbers joined by a hyphen (10012345-10067890), from the tracking code in Convert: Project → Configuration → Tracking code. You can paste the whole code. A/B tests load first on every page, before everything else, so pages don't flash; the Tracking Load Strategy doesn't apply. Because it loads before the page shows, it adds to load time on every page: remove the ID when no tests are running. With the cookie banner on, tests still show to every visitor, and Convert waits to set its tracking cookies and send data until the visitor accepts (Convert's own consent mode). Remove the old pasted Convert code from Custom embeds, or Convert loads twice.
First Interaction waits on a visitor's first page until they click, scroll, type or move the mouse (or 5 seconds after the page loads), which keeps tracking out of speed tests. Visitors from search, other sites, ads or campaign links, and every later page of a visit, are tracked once the page loads. After Page Load always starts tracking once the page loads.
Enable tracking of WooCommerce purchase events (transactions, revenue, products). Requires WooCommerce and a configured Google Analytics or Google Tag Manager ID above. This will send a 'purchase' event to your analytics when an order is completed.
Off by default.
Log all GA4 ecommerce events to the browser console — including events that are blocked by gates (toggle disabled, no consent, admin, etc.). Use this for testing and development only.
Off by default.