Install Apex on Shopify
Connect the Apex Shopify app, enable the storefront app embed, and understand what Shopify data Apex receives.
The Apex Shopify app connects your Shopify store to Apex through Shopify OAuth. In Apex, the install button starts /api/shopify/auth?shopify_domain=<store>.myshopify.com for your permanent Shopify domain. After OAuth succeeds, Apex stores the Shopify installation, registers Shopify web pixel settings for commerce events, and configures the storefront app embed settings used by the theme extension.
Before you start
- Use the permanent .myshopify.com domain for the store, not only the public storefront domain.
- Install from Apex onboarding or the Installation page so the app connects to the right Apex shop.
- Have access to the Shopify admin and the live theme editor.
Install the app
- Open Apex onboarding or the Installation page for the shop.
- Choose the Shopify install action. Apex redirects you to Shopify OAuth for the selected .myshopify.com store.
- Approve the requested Shopify app access in Shopify.
- Return to Apex after the callback completes.
Turn on the storefront embed
The OAuth callback prepares the app embed configuration, but the live theme still needs the Apex embed enabled in Shopify. From Apex, open Installation and use the app embed action. Shopify opens the theme editor with the Apex embed selected. Enable it and save the live theme.
What Apex receives
The Shopify web pixel forwards enabled Shopify customer events to the Apex event endpoint. The current pixel subscribes to checkout, cart, product, collection, search, alert, UI extension error, and checkout experiment events. Apex also syncs active experiment assignment data to the pixel so Shopify events can be attributed to the right experiment and variation when assignment data is available.
Troubleshooting
- If OAuth rejects the domain, confirm it is a valid *.myshopify.com host.
- If the app is connected but no storefront events arrive, confirm the Apex app embed is enabled and saved on the live theme.
- If you changed themes after setup, enable the embed again on the published theme.