Home Getting Started and Administration Setting Up the Shopify Custom Pixel

Setting Up the Shopify Custom Pixel

Last updated on Jun 16, 2026

Introduction

Shopify Custom pixels help you collect customer events on even more pages of your online store, such as the checkout and post-purchase pages. If there isn't an app pixel available that meets your requirements, then you can use custom pixels on your store to track customer events without having to modify your theme code.

Custom pixels are loaded in a Lax sandbox, designed for improved security and control over the data that you send to third parties. Not all pixel functionality works in the sandbox, and you might need to consult your third-party service provider for help.

Manage Custom Pixels

You can manage your custom pixels in the Customer events section of your Shopify admin.

2.1 Add a Custom Pixel

Before you begin: Make sure to remove or modify any existing pixels to prevent duplicate counting of customer events. Existing pixel/tag code should be manually removed from any place it exists, such as theme.liquid, checkout.liquid (Plus merchants only), and the Additional scripts in your checkout settings.

Steps

  1. From your Shopify admin, go to Settings → Customer events

  2. Click the Add custom pixel button to open the event editor.

  3. In the Add custom pixel popup, add the name of the pixel L5-Tracker.

  4. Click Add pixel. Provide your pixel a unique name. If you enter the name of a custom pixel that already exists, then you'll be prompted to give your pixel a different name.

  5. Once the Custom pixel is created, it will provide you with a code editor window.

  6. Navigate to your Tag Management page, and Copy your Pixel code which is seen when you scroll to the end of the page.

2.2 Connect a Custom Pixel

After a custom pixel has been added, you need to connect the pixel to your store so that it can start tracking customer events.

Steps

  1. From the Customer events page in your Shopify admin, click Custom pixels.

  2. Custom pixels that aren't currently connected are displayed under the heading Disconnected pixels. Click Connect on the appropriate custom pixel line.

Once connected, the pixel status updates to Connected and begins tracking customer events on your store.

Troubleshooting

My pixel still shows "Disconnected" Adding the pixel and connecting it are two separate actions. After saving, make sure you've clicked Connect — either from the Code Editor Window or from the ⋯ menu on the pixel line in the Custom pixels list.

I'm seeing duplicate events This usually means an older pixel or tag is still firing alongside the new one. Confirm you've removed any previous LayerFive or tracking code from theme.liquid, checkout.liquid (Plus merchants only), and the Additional scripts section of your checkout settings.

I don't have my Client ID Your Client ID is provided by the LayerFive support team. Reach out to your CSM if you don't have it.

Events aren't appearing Confirm you replaced both CLIENT_ID and DOMAIN placeholders with your actual values, and that your domain is formatted with a leading dot and no http/https prefix (e.g. .example.com).

Related Articles