TreStack Follow the build

Docs, Performance and themes

Theme compatibility

What the app needs from a theme, what has and has not been tested, page builders, and what to redo when you switch or upgrade your theme.

All docsAsk a person
Category
Reference
Updated
26 September 2026
Applies to
TreStack Timer, every plan

What the app needs from a theme

The app embed, which the theme editor lists under App embeds. With it on, each automatic timer finds its spot in the page the theme renders: the Add to cart form for a product timer, the top or bottom of the page for a bar, the main content for a landing timer, and the cart form or drawer for a cart timer.

Custom positions need the app block, and app blocks need a theme whose sections accept them, which is what Online Store 2.0 themes do. The measurements on the performance page were taken on Shopify Horizon theme.

Older themes and page builders

A vintage theme has no sections that accept app blocks, so custom positions are not available on one. The app checks your live theme and says so on the Placement tab instead of offering an app block that would not work. We have not tested the automatic positions on vintage themes. Try it on the Free plan, and write to us with the theme name before you pay for a plan.

A page builder section that accepts app blocks can hold the app block. A product page built by a page builder may use its own Add to cart form, which the automatic product position may not find. In that case, set the timer to Custom position and place the app block inside the builder section.

Switching or upgrading a theme

Your timers live in the app, so a new theme changes none of them. What belongs to a theme is the app embed switch, its cart drawer selector if you set one, and any app blocks. Turn the embed on in the new theme and place the blocks again. The app checks the embed status again when a theme is published, so the app Home tells you if you missed it.

Switching themes, in four steps.

In order. Each step assumes the one before it is finished, so skipping one is how the last step fails for a reason that looks unrelated.

  1. Step one

    List your app blocks

    Note which timers use a custom position and where their blocks sit. Screenshots are faster than notes.

  2. Step two

    Add the new theme as a draft

    Keep it beside the live theme. Do not publish it yet.

  3. Step three

    Turn on the embed and place the blocks

    On the draft, then preview product, collection, and cart pages with items in the cart.

  4. Step four

    Publish and check the app Home

    The embed status should read on for the new live theme.

Settings reference

The controls this page touches, with what each one does and the default the app ships where there is one.

Measured on
Shopify Horizon theme, for the performance measurement of 25 September 2026.
Custom positions
Need a theme whose sections accept app blocks, as Online Store 2.0 themes do.
Vintage themes
Not tested. No app block sections, so no custom positions.
Product position
Found from the Add to cart form of the theme. Use a custom position where it is not found.
Cart drawer
Found in a general way, with a selector on the app embed for drawers that are not.
Theme switch
The embed, its selector, and app blocks are per theme. Timers are in the app and do not change.

If this does not work

The failures most likely on this procedure, with the check that resolves each one. If none of them fit, we would rather have the store URL than a guess.

Send us the store URL
The product timer does not show on your theme

The theme or a page builder may use an Add to cart form the automatic position does not find. Set the timer to Custom position and place the app block where you want it. Then tell us the theme name, so we can look at supporting it directly.

Your theme already has an announcement bar

Two bars stacked push the page content down and ask shoppers to read two things. Decide which one carries the message and turn the other off for as long as the timer runs.

Keep reading

Performance and themes has 3 pages. The rest of the docs index is one click away.