Install on Shopify
Add the LuluDesk chat widget to your Shopify store by pasting one script tag into your theme. The widget runs on every page of the storefront and answers questions using whatever knowledge sources you have indexed in LuluDesk.
This is a script-snippet install. There is no Shopify App Store listing yet, no deep product-catalog sync, and no checkout-event hooks. Those are tracked for v2 (see Limitations below).
Grab your install snippet
Open your LuluDesk dashboard, Widget tab, and copy the script under Embed snippet. It already contains your unique install_token:
<script src="https://luluclaw.com/widget/v1/YOUR_INSTALL_TOKEN" async></script>Keep the token private. Anyone with the token can embed your widget unless you add allowed domains in the Widget tab.
Open your theme code in Shopify
In your Shopify admin, go to Online Store, then Themes. On the theme you want to edit (usually your live theme), click the three-dot menu and choose Edit code.
Under the Layout folder in the left sidebar, click theme.liquid. This is the master template Shopify renders on every storefront page.
If you want to keep your live theme untouched while testing, duplicate it first via the same three-dot menu, then edit the copy and use Shopify's preview link.
Paste the snippet before </body>
Scroll to the bottom of theme.liquid. Find the closing </body> tag. Paste the script tag immediately above it:
{% comment %} LuluDesk widget {% endcomment %}
<script src="https://luluclaw.com/widget/v1/YOUR_INSTALL_TOKEN" async></script>
</body>
</html>Click Save. Shopify deploys the change instantly, no rebuild step.
Verify on the storefront
Open your storefront in a new tab (incognito is fine). Within a few seconds, a pink chat button should appear in the bottom-right corner. Click it to confirm the chat opens and replies.
Back in LuluDesk, the Widget tab status flips from Pending to Active once the first beacon lands.
Indexing your product pages
The widget itself does not pull product data from Shopify. To let the assistant answer product questions, add your storefront URL as a knowledge source in the Sources tab. LuluDesk crawls public product pages, collection pages, and your FAQ or policy pages, then indexes them so the assistant can cite them.
For best results, point at your sitemap (typically https://yourstore.com/sitemap.xml) so new products and price changes are picked up on the configured recrawl schedule.
Limitations (and what is coming)
- No Shopify App Store listing. Today this is a script-snippet install, not a Shopify app. You add it by editing
theme.liquiddirectly. - No live catalog sync. Product data comes from crawling your public storefront, not from the Shopify Admin API. If a product is unlisted or behind a password, the assistant cannot see it.
- No checkout or order context.The assistant does not know about a visitor's cart, recent orders, or shipping status. Order-status questions need a human handoff.
- Checkout pages.Shopify's hosted checkout is a separate domain in most plans and the widget will not load there. The widget is for the storefront only.
A Shopify App Store listing with native catalog and order sync is on the roadmap. Track progress in the changelog.
Removing the widget
Open theme.liquid again, delete the script line you added, and click Save. The widget disappears from the storefront immediately. You can also disable the workspace in LuluDesk to stop it loading without editing the theme.