Skip to main content

FERMÀT Pixel v2 Installation Guide - Shopify Brands

Complete guide to installing and configuring the FERMÀT Pixel v2 for Shopify brands, from Shopify connection to verification and recording privacy FAQs.

Complete guide to installing and configuring the FERMÀT Pixel v2 for Shopify brands. If your store runs on a different ecommerce backend, follow the direct script / Google Tag Manager installation guide instead.

1. Connect your Shopify store

The FERMÀT Pixel can only be installed after your Shopify account is connected. Complete this step first, before enabling the pixel.

2. Sync your Shopify data

Sync your Shopify data via our Airbyte connection to power intelligent merchandising, customer upsells, PDP and bundle recommendations, and more.

3. Install the FERMÀT Pixel

Prerequisite: your Shopify account must already be connected, otherwise the data will not sync properly. If you haven't connected it, go back and do that before moving on.

Under Manage Integrations → Fermat Pixel, you will see the option to directly install the pixel using a theme embed.

  1. Open Shopify
    Click the Enable on Shopify button to open the setup screen in a new tab.

  2. Turn on Fermat Pixel
    In Shopify, switch on the Fermat Pixel toggle for the live storefront. This is the only Shopify setting needed.

  3. Save changes
    Hit Save in the top right corner in Shopify, then return to the FERMÀT dashboard to confirm setup is active.

  4. Toggle on tracking
    Back in the FERMÀT dashboard, make sure both Pixel tracking and Behavioral insights are toggled on.

Important: only install the FERMÀT Pixel via the theme embed through the dashboard. Do not add FERMÀT as a Shopify Custom Pixel: Custom Pixels run in a sandbox and will not capture interactions or recordings.

4. Verify your installation

  1. Open your site in a browser
    Navigate to any page where the pixel is installed.

  2. Open Developer Tools
    Press F12, or right-click → Inspect, and go to the Console tab.

  3. Check the pixel status
    Run window.fermat({ method: "status" }); in the console. You should see a response containing initialized: true. Success looks like this: { initialized: true, version: "2.0.0", recording: true, eventCount: 1, ... }

Separately, once data has been collected for a few hours, you can also verify pixel health inside the FERMÀT platform, under the same Manage Integrations → Fermat Pixel page, where two dashboards report on your pixel health.

Note: activity on these dashboards is not immediate, and they may initially report the pixel as unhealthy or show no activity. Check back after a few hours.

5. FAQs

Does the pixel record user sessions?
The pixel automatically masks sensitive data in recordings:

  • All form inputs, including text, email, phone, password, textarea, select, and date pickers

  • Common PII patterns, including email addresses, phone numbers, SSNs, credit card numbers, IP addresses, dates of birth, and passport or license numbers

How do I mask sensitive content in recordings?
Customer names, street addresses, and custom account numbers displayed as plain text are not automatically detected. If your site displays these, add one of the following CSS classes.

Blur content, which still occupies space but is unreadable:

<div class="claire-mask">Sensitive content</div>

Block content entirely, so it is not recorded at all:

<div class="claire-block">Hidden from recordings</div>

Related Articles
Connecting Shopify to FERMÀT
FERMÀT Pixel v2 Installation Guide - Direct Script & Google Tag Manager
Did this answer your question?