Install Theme Extension

The Theme App Extension is an optional block you add to your Shopify theme. It works together with the Web Pixel to capture referral clicks even in edge cases — for example, when a visitor's browser blocks the pixel, or when your theme uses custom checkout routing.

For most stores on a stock Shopify theme, the Web Pixel alone is enough. The Theme Extension gives you extra coverage and is especially recommended if you run a headless store or a custom theme.

Steps

1. In your Shopify admin, go to Online Store → Themes.
2. Click Customize on your active theme.
3. In the theme editor, click the App embeds icon in the left sidebar (looks like a puzzle piece).
4. Find Avada Affiliate Tracking in the list and toggle it On.
5. Click Save in the top-right.

The extension is now live on every page of your storefront.

Verifying it is active

1. Open any product page on your storefront in a new browser tab.
2. Right-click → View Page Source (or press Ctrl+U / Cmd+U).
3. Press Ctrl+F / Cmd+F and search for avada-affiliate or affily.

You should find a small <script> tag referencing the extension. If nothing appears, the embed is not saved — go back to the theme editor and re-enable it.

What the extension does

• Reads the affily_ref query param from the URL on any page load.
• Stores it in localStorage as a backup, in case the Web Pixel cookie is blocked.
• Attaches the referral code to checkout requests so orders can be matched more reliably.
• Records UTM parameters (utm_source, utm_medium, utm_campaign) alongside the referral for analytics.

It does not add any visible UI to your storefront. Customers never see it.

Performance impact

The extension is about 4 KB minified and loads asynchronously after the main page content. It does not affect page speed or Core Web Vitals measurably.

Turning it off

If you ever need to disable the extension (e.g., for testing), go back to App embeds and toggle it off. Referral-link tracking will fall back to the Web Pixel only.

Next step

Tracking is now fully set up. Continue to Quick Start to create your first program and start recruiting affiliates.