Setting up tracking pixels for your website

Notice: These instructions are for new Website Builder, which is continuously evolving based on customer feedback. Some details seen here may differ from what you see in-app.

Adding tracking pixels to your beehiiv website is a powerful way to better understand how visitors interact with your content. Pixels help you monitor performance, optimize ad campaigns, and gather deeper visibility into site activity beyond what's available in your built-in Posts, Clicks, and Subscribers reports.

Tracking pixels apply to your beehiiv website pages only and are not added to your email newsletters. In this article, you'll find an overview of what tracking pixels are, a list of supported platforms, step-by-step setup instructions, and troubleshooting guidance for pixels that aren't loading or firing.


What are tracking pixels? 

Tracking pixels, also known as web beacons or pixel tags, are tiny, invisible snippets of code embedded in web pages or emails. They track user behavior, such as:

  • Pageviews
  • Clicks
  • Conversions
  • Email Opens

When a visitor lands on a page with a pixel, the pixel sends a request to the sender's server, providing information such as the time, date, recipient's IP address, and the pixel's source (e.g., Meta, Google, TikTok), helping you measure engagement and campaign success.

Note for advertisers: If you’re running campaigns through the beehiiv Ad Network, refer to our guide on implementing the beehiiv Pixel instead.

Supported pixel types

You can add tracking pixels from the following platforms:

  • Meta (Facebook)
  • X (Twitter)
  • TikTok
  • Google Analytics 4 (GA4) (Known as a Measurement ID in GA4)
  • Google Tag Manager (GTM) (Known as a Container ID in GTM)
  • Google Search Console (GSC)

How to add tracking pixels in the Website Builder

Reminder: In order to add a tracking pixel to your beehiiv website, you’ll first need to retrieve the pixel ID or verification code from each platform. For GA4, this pixel is known as a Measurement ID. For GTM, this pixel is known as a Container ID.
  1. Open the builder, go to Website > Builder. 
     
  2. From the left panel, click on the Settings icon, then select on All general settings.
  3. Your General Site Settings will open. Click on Pixels in the left panel. 
  4. Enter your pixel IDs or verification codes for each platform. 

    Reminder: Changes save automatically. If your site has published at least once before, that's all you need to do, your pixel will go live on its own. If this is your first time publishing your site, pixel settings (like the rest of your builder changes) stay in draft until you publish your site for the first time. See "Your site has never been published" below if your pixel isn't appearing yet.

Pro Tip: Looking to add social media links instead? Go to Website > Builder > Settings Icon > All Settings > Socials.

Adding tracking scripts beyond the six supported platforms

The Pixels settings page covers the most common tracking platforms (Meta, X, TikTok, GA4, GTM, and Google Search Console), but some third-party tools, such as donation platforms, referral or recommendation widgets, or other embeddable services, don't have a dedicated field here.

For a script on a single page: Add it as an HTML block directly on that page. See Using HTML in the Website Builder for how to add and configure an HTML block, plus what's supported.

For a script that needs to run site-wide: Add your Google Tag Manager Container ID under Pixels as described above, then configure the tool's script as a tag inside your GTM container. GTM tags fire across your whole site once the container is published, so this is the better option for tools like SparkLoop that need to run on every page rather than one.

Reminder: Tools like SparkLoop aren't native beehiiv integrations. They rely on GTM (or, for page-specific embeds, an HTML block) rather than a pixel field of their own. beehiiv support can confirm whether your GTM container or HTML block is loading correctly, but can't troubleshoot a third-party tool's own script logic.

Troubleshooting pixels that aren't loading or firing

If your pixel ID is saved correctly but your tracking platform isn't detecting events or pageviews, the most common causes are listed below.

Tech Note: Browser extensions like Meta Pixel Helper or a platform's own tag-checking tool are convenient, but they occasionally report a pixel as missing even when it's firing correctly. If a verification extension shows no detection but you've confirmed your pixel ID and Cookie Banner settings are correct, you can double-check directly in your browser's developer tools: right-click the page, select Inspect, open the Network tab, reload the page, and look for a request to your platform's tracking domain.

Your site has never been published

If you added a pixel ID and it isn't showing up at all, check whether your website has ever been published. Pixel settings, like every other change in the Website Builder, save automatically to your draft, but they don't reach your live site until you publish for the first time.

To publish your site, click on Publish in the top navbar, then Publish to live site. Once your site has published at least once, this step isn't needed again: future settings changes, including pixel updates, save and apply automatically.

Cookie Banner is blocking the pixel

If your publication has the Cookie Banner enabled under GDPR, CCPA, & Compliance in your website settings, tracking pixels will not load until a visitor clicks ‘Accept’ on the banner. This applies to all supported pixel types: Meta, GA4, GTM, TikTok, and X. If a visitor hasn't interacted with the banner yet, no pixel data will be collected for that session.

To test, visit your live website in a private or incognito browser window, click Accept on the cookie banner, then re-test your pixel using your platform's verification tool (e.g., Meta Pixel Helper, Google Tag Assistant).

Tech Note: Pixel scripts load on page load after consent is recorded. A visitor who accepts the banner mid-session will have their data collected from the next page load onward, not retroactively for the current page.

Meta pixel isn't recording conversions

If your Meta pixel is firing correctly (confirmed via Meta Pixel Helper) but conversion events such as subscribe completions aren't appearing in Meta Events Manager, the most common cause is that a conversion event hasn't been configured in Meta. Pixels track pageviews by default, but conversion events require additional setup in Meta's Events Manager or through a GTM trigger mapped to a specific action.

To track subscribe conversions specifically, you'll need to configure a custom conversion in Meta Events Manager based on the thank-you or confirmation page URL that subscribers land on after signing up. If your publication uses double opt-in, note that the confirmation step adds an extra page load between signup and conversion. Confirm your conversion trigger accounts for the full confirmation flow.

Pixel ID is in the wrong format

Each platform uses a specific ID format. If your pixel ID doesn't match the expected format, it won't fire. 

Confirm you're using the correct format for each platform:

  • Meta: Numeric ID only (e.g., 123456789012345).
  • GA4: Starts with G- (e.g., G-XXXXXXXXXX).
  • GTM: Starts with GTM- (e.g., GTM-XXXXXXX).
  • TikTok: Alphanumeric code.
  • Google Search Console: Verification meta tag content value only.
Reminder: Also check for an accidental leading or trailing space in the ID field, which is easy to introduce when copying and pasting from another platform. A GTM Container ID with a stray space (for example, ‘ GTM-XXXXXXX’ instead of ‘GTM-XXXXXXX’) will prevent the entire container from loading, not just the affected tag. Click into the field, select all, delete, and re-paste to rule this out.

GTM container isn't published

If you're using Google Tag Manager, changes made in GTM only take effect once the container is published, not just saved. If your GTM-based tags aren't firing, confirm your container has been submitted and published in GTM before testing.

Custom HTML on the same page may be conflicting

If you have HTML blocks on the same page as your pixel, poorly scoped styles or scripts in those blocks could interfere with pixel loading. Test the page in Preview with your HTML blocks temporarily removed to isolate whether a conflict exists.

Pixel code still appears in your page source after removal

If you removed a pixel ID from your settings but still see its code when viewing your page source, try the following:

  1. Clear your browser cache and reload in a private or incognito window: Your browser may be showing a cached copy of the page.
  2. Give it a few minutes: Pixel removal doesn't always take effect on your live site immediately.
  3. Confirm the field is actually empty: A leftover space or partial ID in the Pixels settings field will still cause the pixel to load. Click into the field to check.
Tech Note: If you originally added the pixel through Google Tag Manager rather than the Pixels settings page, removing it from beehiiv won't remove it from your site. You'll need to remove or pause the corresponding tag in your GTM container and publish the container.

Still not working?

If your pixel still isn't firing after trying the steps above, have the following ready before contacting support: which pixel platform you're using, the pixel ID you entered, whether your Cookie Banner is enabled, and a screenshot of the error or non-detection message from your platform's verification tool. Visit the Help page in your account, or click the Chatbot Assistant on this page for immediate assistance.


Related tools and features

Tracking pixels measure visitor behavior on your website pages. For other tracking and attribution tools in beehiiv, see:



Was this article helpful?

Related Articles