Skip to main content

Storefront block extension

Widgets render in your storefront through the APIEase theme app block. The block loads the widget by handle and injects its Liquid and JavaScript into the page.

Before you start​

  • Create and save a widget in APIEase.
  • Copy the widget handle from the widget editor.
  • In Shopify Theme Editor, enable the APIEase Widget App Embed (you typically only need to do this once per theme).

Add the widget to your theme​

  1. Open Shopify admin and go to Online Store -> Themes.
  2. Select Customize on the theme you want to update.
  3. Open App embeds and enable APIEase Widget App Embed, then save.
  4. Navigate to the page or template where the widget should appear.
  5. Add the APIEase App Block block to the section.
  6. Paste the widget handle into the Widget handle setting.
  7. Save the theme changes.

Update or move a widget​

  • If you change the widget handle, update the block setting to match.
  • To move the widget, remove the block from the current section and add it to the new location.

Troubleshooting​

  • If the block shows "Widget handle not configured", confirm the handle value is set and saved.
  • If the widget does not render, confirm APIEase Widget App Embed is enabled and that the handle matches exactly.