Theme compatibility and theme health
What EnKart needs from a theme, what each Theme health status means, and how offers reach themes without an app block slot.
What EnKart needs from a theme#
- For the Offers block: a product page (and, for cart page offers, a cart page) built from sections that accept app blocks. Shopify's free themes, Dawn and Horizon among them, do.
- For the Cart drawer embed: nothing more. It finds your theme's cart drawer by its structure, the drawer that holds the checkout button next to the cart lines, so it needs no settings for your theme. When your theme redraws its cart after a change, the offers are put back.
If a product page cannot hold an app block, the embed places product page offers under Add to cart by itself. See A theme says Needs setup.
Theme health#
Settings > Theme health shows where offers show on your themes. It is checked daily, again when you come back to EnKart from the theme editor, and whenever you press Check now.
Your live theme comes first, place by place: Product page, Cart drawer and Cart page, each with its status and the one thing to do about it.
| Status | What it means | What to do |
|---|---|---|
| Rendering | The block or embed is placed and switched on | Nothing |
| Not added | The block is not in that template, or the embed is off | Add (or Switch on for the embed) opens the theme editor in the right place. Press Save there |
| Needs setup | The template has no place for an app block | On a product page, Switch on cart drawer. See A theme says Needs setup |
| Could not check | EnKart could not read that part of the theme | Try again. If it keeps failing, email support |
| Stopped rendering | The block or embed is placed and switched on, but shoppers have not seen one offer there for three days, where they used to every day | Open theme editor and check the block or embed is still there and saved, then open that page on your store. If the offers are still missing, email support with the page's address. It goes back to Rendering at the next check after shoppers see an offer there again |
When a place stops, the theme itself reads Stopped rendering, and Home and Settings say "Offers stopped showing on" your theme.
Stopped rendering is worked out from offer views, which shoppers who decline analytics never send. A store where most shoppers decline does not have enough views for it, so it never shows there.
Other themes lists your other themes, one line each, with Offers on, Partly set up or Not set up, and Set up to add what is missing. Set a theme up before you publish it, and its offers go live with it. Themes the Shopify CLI creates for developers are left out.
The check reads your theme's saved files. A change you made in the theme editor but did not save does not count yet.
Another offer app on the same theme#
If another app's offer block or embed is switched on in your live theme, Settings says so and names it, because shoppers may see two offer boxes on one page. EnKart never turns anything off. See Two offer boxes on one page.
Theme updates#
EnKart adds nothing to your theme files, so a theme update cannot break it. The block and embed live in the theme's own settings; after a major update, check Theme health.
If something looks wrong on your theme#
Email support@enstacked.com with your store URL, the theme name and version, a link to a product page showing the problem, and a screenshot. Run window.Shopify.theme.name in your browser's console on the storefront to see which theme you are actually looking at.