Skip to main content

Shopify storefront embed

The storefront chat button is a theme app embed, delivered by the Boldally Shopify app.

Who can do this

  • Developer
  • Owner
  • Admin

How it is delivered​

Installing the Boldally app on a Shopify store makes the embed available to that store's themes. It is not injected automatically: a merchant enables it per theme from the theme editor's App embeds tab.

That means:

  • No script tag to paste into theme.liquid.
  • No code in your theme repository to maintain.
  • Uninstalling the app removes the embed cleanly.
  • The embed is per theme. Switching themes, duplicating a theme, or publishing a new one means enabling it again on that theme.

Enable it​

  1. In Boldally Chat, go to SettingsIntegrations → Shopify.

  2. Under Storefront widget, select Open theme editor. That opens /admin/themes/current/editor?context=apps for the store, which is the published theme's App embeds tab.

  3. Toggle the Boldally embed on and Save.

The deep link deliberately does not auto-activate the embed by id. Immediately after an app deploy, Shopify's theme service can lag behind the current app version and an auto-activate link errors with "App embed does not exist". Picking it from the list once avoids that.

Verify it is live​

  1. Open the storefront in a private window.

  2. Confirm the floating button renders.

  3. Tap it and send a message.

  4. Check the conversation lands in Inbox as unassigned, with a contact whose source is WhatsApp.

If the embed is not in the list​

Usually a propagation delay. Wait a few minutes, reload the theme editor and look again.

If it still does not appear:

  • Confirm the app is actually installed: the Shopify card in SettingsIntegrations should read Connected.
  • Confirm you are editing the theme you think you are. The link goes to the published theme.
  • If the store was connected through Shopify (Testing), the embed belongs to that app rather than the public one.
Storefront chat button
The merchant-facing version of this page.
Shopify troubleshooting
Connection health, reconnects, and missing events.
Last updated on