Pixelflow
Wordpress

Wordpress

This guide shows you how to install PixelFlow on WordPress. This method involves embedding the tracking script directly in your site's header using a code snippet plugin.

Overview

Manual WordPress setup requires you to copy the PixelFlow tracking script from your dashboard and paste it into your site's header using a free plugin like WPCode. After embedding the script, you'll configure event tracking through the PixelFlow dashboard.

1: Install WPCode Plugin

WPCode is a free WordPress plugin that lets you safely add code snippets to your site's header without editing theme files.

  1. In your WordPress admin panel, go to Plugins → Add New

  2. Search for "Code Snippets"

  3. Click Install Now on the "Code Snippets" plugin

  4. Click Activate after installation completes

Alternative header injection plugins like "Insert Headers and Footers" or "Header Footer Code Manager" will also work. The key is adding code to the <head> section of your site.

2: Login to PixelFlow Dashboard

  1. Visit dashboard.pixelflow.so

  2. Click Login or Start Free Trial if you're a new user

  3. Enter your credentials or sign in with Google

3: Add Your Site in PixelFlow

After logging in, the setup wizard will automatically open to guide you through configuration.

  1. In the wizard's first step, enter your WordPress site domain (e.g., yoursite.com)

  2. Select your currency from the dropdown (optional, used for eCommerce tracking)

  3. Click Continue

Your WordPress site is now connected to PixelFlow and will appear in your Sites list.

4. Add Your Meta CAPI Acess Token

PixelFlow loads BOTH your Facebook Pixel and Facebook Conversions API simultaneously with automatic event deduplication. This ensures the most accurate tracking while bypassing ad blockers and iOS restrictions.

  1. Enter a Pixel Name (can be any name for your reference, e.g., "Main Website Pixel")

  2. Add your Meta Pixel ID (also called Dataset ID; find this in Facebook Events Manager)

  3. Add your Meta Pixel Access Token (go to Meta Events Manager > Datasets > select your dataset (Pixel) > Click Settings > Scroll down to Setup Direct Integration section > Click Generate Access Token > Copy it and paste into PixelFlow)

  4. Click Next

Need help finding your credentials? Check out our guide: How to Find Your Meta Pixel ID and Access Token

5: Copy Your PixelFlow Script

In the third wizard step, you'll get your unique tracking script:

  1. The wizard will display a code snippet starting with <script>

  2. Click the Copy to Clipboard button (or manually select and copy the entire script)

  3. Keep this script ready for the next step

6: Paste Script in WPCode

Now you'll embed the PixelFlow script in your WordPress site's header:

  1. In your WordPress admin, go to Code Snippets → Header & Footer

  2. Scroll to the Header section

  3. Paste your PixelFlow script into the header text box

  4. Click Save Changes

Make sure you paste the script in the Header section, not the Footer. The script must load in the <head> of your pages for proper tracking.

7: Clear Your WordPress Cache

If you use any caching plugins, you must clear your cache for the script to appear on your live site.

Common caching plugins:

  • WP Rocket: WP Rocket → Clear Cache

  • W3 Total Cache: Performance → Dashboard → Empty All Caches

  • WP Super Cache: Settings → WP Super Cache → Delete Cache

  • LiteSpeed Cache: LiteSpeed Cache → Toolbox → Purge All

Your PixelFlow tracking script is now live on your WordPress site!

8: Verify Events Are Tracking

Return to the PixelFlow dashboard wizard to confirm your setup is working:

  1. In the fourth wizard step, the dashboard will automatically poll for events every 10 seconds

  2. Open your live website in a new browser window or incognito/private mode

  3. Navigate to a few pages on your site

  4. Return to the wizard—when the first Page View event is detected, you'll see:

    • A confetti animation celebrating your successful setup

    • A green congratulations modal

    • Your site status will change to "Connected"

Setup complete! PixelFlow is now tracking Page View events. Events should appear in your dashboard within 2-3 minutes.

No events appearing? Verify that: • You pasted the script in the Header section (not Footer) • You clicked "Save Changes" in WPCode • You cleared your cache • You're visiting the live site (not localhost or a staging environment)

9: Configure Additional Event Tracking

After the wizard closes, you can set up tracking for specific user actions beyond Page Views.

Available tracking methods:

Was this helpful?