Shopify

The easiest way to add Inclusify to your Shopify store. One-click installation with our native app.

Installation Steps

1

Install the App

Visit the Shopify App Store and click "Add app" to install Inclusify on your store.

2

Enable App Embed

After installation, go to Online Store, find the theme you want to edit and click Edit theme. In the theme editor, click the App embeds icon in the sidebar and toggle Inclusify Accessibility Widget on.

3

Save the theme

Click Save in the theme editor. Save only affects the theme you are editing, so enable the embed on the theme that is actually published.

4

Configure the widget in the app

The app embed itself has one setting - on or off. Position, colour and trigger size live in the Inclusify app: open it from Apps Inclusify in your Shopify admin and go to Customize. Customization needs the Starter plan or higher. Saved changes reach the storefront once the cached widget bundle expires, not instantly.

Alternative: Manual Installation

This replaces step 2 only, not step 1. Use one method or the other: leaving the app embed on and pasting the tag as well loads the widget twice.

Register the domain first

Installing the app in step 1 is what registers the store with Inclusify - the install adds your .myshopify.com domain to your account. The manual snippet registers nothing on its own, so pasting it without the app install fails silently: the script URL still returns HTTP 200, but what it serves is a single console.log saying the domain is not registered. There is no error to find and no widget appears.

  1. Go to Online Store Themes
  2. Click the ... menu beside the theme, then Edit code
  3. Open theme.liquid
  4. Paste the following before the closing </body> tag:
theme.liquid
<script src="https://app.inclusifyapp.com/w/YOUR-STORE.myshopify.com.js" async></script>

Replace YOUR-STORE with your Shopify store subdomain. Use the permanent .myshopify.com domain, not your custom storefront domain - the bundle it serves authorises every domain registered to the store, so the widget still runs on the custom domain.

Features

  • • One-click installation via Shopify App Store
  • • Turn the widget on or off from the theme editor, with no theme code to edit
  • • Automatic updates (no manual code changes needed)
  • • App embeds are supported on vintage and Online Store 2.0 themes, so any theme works
  • • Monthly visitor usage and store content checks inside the Shopify admin

Verify the installation

  1. Open your live storefront in a private window — the theme editor preview can render app embeds that are not yet published.
  2. Look for the accessibility icon in the corner of the page and open it.
  3. In your browser's DevTools Network tab, filter for "w/" and confirm a request to app.inclusifyapp.com returns 200.
  4. Check a product page and a collection page as well as the home page: app embeds inject into the theme layout, so any template that does not use the default layout will not get the script.

Widget bundles are served from a CDN and cached for a few hours. If you changed widget settings in the panel and the site still shows the old configuration, wait for the cache to expire or load the script URL directly with a cache-busting query string (`?v=2`) to confirm the new version is being served.

Troubleshooting Shopify installs

The app embed is toggled on but nothing appears on the live store.
Theme editor changes are not live until you press Save, and Save only affects the theme you are editing. If you enabled the embed on a draft or duplicated theme, publish that theme or repeat the toggle on the published one under Online Store → Themes.
The widget appears twice.
The app embed and a manual theme.liquid script tag are both active. Pick one — remove the <script> tag from theme.liquid, or leave the tag in place and toggle the app embed off.
The widget is missing on checkout.
Shopify does not run theme app embeds on checkout, and the Additional scripts box under Settings → Checkout is no longer a way round it: Shopify sunset that field for Plus stores in August 2025 and for other stores in August 2026, in favour of checkout UI extensions and web pixels. Neither of those loads the widget bundle, so treat checkout as outside the widget's reach.
Nothing loads and the store asks for a password.
Password-protected development stores block third-party scripts for logged-out visitors. Remove the storefront password or test while logged into the admin.

Shopify questions

Do I need the app embed if I already pasted the script into theme.liquid?
No. Either method loads the same widget. The app embed is preferable because it survives theme updates, whereas a theme.liquid edit is lost when you switch or update themes. It is not where you configure the widget: the embed has a single on/off checkbox, and position, colour and trigger size live in the Inclusify app under Apps → Inclusify → Customize, which needs the Starter plan or higher.
Will installing the widget slow my store down?
No. The manual snippet is async, which is the recommended install everywhere; the app embed uses defer. Neither blocks the parser or delays rendering, and both are one request from a CDN edge - the difference is only when the bundle runs, not whether it holds the page up.
Does it work with Shopify Hydrogen or a headless storefront?
Yes, but not through the app embed — headless storefronts do not use Liquid themes. Add the script tag to your Hydrogen or custom frontend the same way you would for any React app; see the React / Next.js guide.
Which themes are supported?
All of them. Shopify supports app embed blocks in every theme, vintage and Online Store 2.0 alike - the Online Store 2.0 requirement applies to app blocks that sit inside a section, which is not what this is. The manual theme.liquid method is an alternative, not a fallback for older themes.

Related