How to Enable the Shopify App Embed

The Oshi app embed is a lightweight script that runs on your Shopify storefront. It ensures that when customers arrive through a referral or affiliate link, the visit is properly tracked and attributed — even if they browse multiple pages before purchasing.

Without the app embed, referral attribution relies solely on checkout data, which can miss some visits. Enabling it takes about a minute.

Video Walkthrough

Watch the quick setup video: How to Enable the Shopify App Embed

Steps

Step 1: Open the Theme Editor

1. From your Oshi dashboard, go to Connections in the left sidebar
2. Click on your Shopify connection
3. In the "Get the most out of Shopify" section, you'll see the app embed checklist item
4. Alternatively, go directly to your Shopify admin and navigate to Online Store > Themes > Customize, then switch to the App embeds tab

You can also go directly to the App Embeds section using this URL pattern:

https://your-store.myshopify.com/admin/themes/current/editor?context=apps

Step 2: Enable the Oshi App Embed

1. In the Theme Editor, look for the App embeds section in the left sidebar
2. Find Oshi Referral Attribution in the list
3. Toggle it on
4. Click Save in the top right corner

Step 3: Verify the Setup

1. Return to your Oshi dashboard
2. Click Verify Setup in the Referral Attribution banner
3. Visit your store in a new tab — this triggers the app embed to confirm it's working
4. The dashboard will automatically detect the confirmation and show a success message

How It Works

When the app embed is active, it runs a small script on every page of your store. When a customer arrives via a referral link (e.g., yourstore.com/?ref=AFFILIATE123), the script captures the referral code and stores it in the customer's browser. This ensures the referral is attributed correctly at checkout, even if the customer navigates to other pages before purchasing.

What's Next

• Add the checkout extension to your Thank You page — Show customers their Bitcoin rewards immediately after purchase.
• Add the checkout extension to your Order Status page — Display rewards info and referral links on the order status page.
• Set up referral rewards — Configure what customers and affiliates earn for referrals.