How to Enable the Superfiliate App Embed on Shopify

Last updated: November 11, 2026

Shopify has introduced changes to how apps load scripts on online stores. As part of these updates, Superfiliate now uses the Superfiliate Widget App Embed to enable storefront features.

This guide explains how to activate the App Embed, verify that it's working, and understand how Shopify's changes may affect your store.

Video Tutorial: How to Enable the Superfiliate App Embed

Watch the video below for a step-by-step walkthrough of how to activate the Superfiliate Widget App Embed in your Shopify store.

If you prefer written instructions, follow the steps below.

Why is the App Embed important?

The Superfiliate App Embed loads the storefront.js script on your Shopify storefront, enabling features such as:

  • Referral Program widgets

  • Loyalty Program widgets

  • Program Portal widgets

The script also helps capture referral information in the shopping cart, which can support conversion attribution.

Important: Superfiliate's Web Pixel is installed automatically when you install the app and operates independently of the App Embed. This means conversion attribution may still work without the App Embed, provided the pixel can associate the customer's visit with their purchase.

However, we strongly recommend keeping the App Embed enabled to ensure all supported storefront features function correctly.

How to Enable the Superfiliate App Embed

You will need access to your Shopify theme settings to complete these steps.

Step 1: Open your Superfiliate settings

  1. Log in to your Superfiliate dashboard.

  2. Navigate to Settings → Developers.

  3. Select the Attribution Script tab.

  4. Locate the Superfiliate App Embed section.

If the App Embed hasn't been activated, its status will appear as Not Added.

Step 2: Activate the App Embed in Shopify

  1. Click Open Theme Editor in the Superfiliate App Embed section.

  2. You'll be redirected to your Shopify Theme Editor.

  3. Under App embeds, locate Superfiliate Widget.

  4. Make sure the toggle is enabled. The link from Superfiliate should automatically enable it in the editor.

  5. Click Save in the top-right corner to apply the changes.

Step 3: Verify the installation

Once you've saved your changes:

  1. Return to Superfiliate → Settings → Developers → Attribution Script.

  2. Confirm that the App Embed status shows Active.

  3. If necessary, use the option to recheck the status.

An Active status confirms that the App Embed is enabled on your published Shopify theme.

You can also visit your published storefront to verify that any configured and published Superfiliate widgets are displaying correctly.

Alternative: Enable the App Embed Directly in Shopify

You can also activate the App Embed without navigating through Superfiliate.

  1. Open your Shopify Admin.

  2. Go to Online Store → Themes.

  3. Click Customize on your published theme.

  4. Open App embeds in the Theme Editor sidebar.

  5. Find Superfiliate Widget and enable it.

  6. Click Save.

Once activated, return to Superfiliate to verify the status.

What Happens If You Change Your Shopify Theme?

App Embeds are configured individually for each Shopify theme.

If you're planning to publish a new theme, make sure the Superfiliate Widget is enabled before switching.

To verify:

  1. Open the new theme in Shopify's Theme Editor.

  2. Navigate to App embeds.

  3. Confirm that Superfiliate Widget is enabled.

  4. If you need to enable it, click Save.

This helps prevent interruptions to your storefront widgets when switching themes.

Important Information for Existing Merchants

Shopify is discontinuing its legacy ScriptTags functionality.

  • October 1, 2026: Shopify stopped allowing apps to create or update ScriptTags. Existing ScriptTags continue to work.

  • March 1, 2027: Shopify will stop loading existing ScriptTags on storefronts.

If your store previously relied on a legacy ScriptTag to load Superfiliate's storefront features, you'll need to transition to the App Embed before March 1, 2027.

If you're unsure whether your store still uses the legacy integration, contact Superfiliate Support for assistance with the migration.

For additional details, see Shopify's official ScriptTags deprecation announcement.

Troubleshooting: Superfiliate Widgets Aren't Showing

If your Referral, Loyalty, or Program Portal widgets aren't appearing on your storefront:

  1. Go to Settings → Developers → Attribution Script in Superfiliate.

  2. Check whether the App Embed shows Active.

  3. If it shows Not Added, follow the activation steps above.

  4. Confirm that the App Embed is enabled on your currently published Shopify theme.

  5. Verify that your widget experience has been configured and published.

  6. Refresh your storefront to check whether the widget appears.

If the issue continues after completing these steps, contact Superfiliate Support.

What If You're Using a Headless Storefront?

If your store uses a headless storefront, such as Shopify Hydrogen, the App Embed setup described above does not automatically install the script on your custom storefront.

Your development team will need to install the Superfiliate storefront.js script directly on your website, call handlePageView() after the script loads, and ensure tracking parameters are preserved through redirects and checkout.

For detailed instructions, refer to our Using Superfiliate with a Headless Storefront guide.

Need Help?

If you're having trouble enabling the App Embed or your storefront widgets aren't working as expected, reach out to Superfiliate Support for assistance.