Getting started

Turning on the app embed and placing the app block

The app embed shows every timer in its automatic position. The app block is only for a custom position. The app opens the theme editor at the right place for both.

Applies to: TreStack Timer, every plan
Updated: 26 September 2026

At a glance

Required: App embed on
Custom position: App block plus Timer ID
Code to paste in the theme: None

Two theme editor pieces, and only one is required

The app embed is a switch under App embeds in the theme editor, listed as Countdown Timer. It loads your published timers onto the storefront, so no timer shows anywhere until it is on. It is the only thing you have to turn on.

The app block, listed as Countdown timer in the Add block menu, is optional. You only need it for a timer set to Custom position, or when you want a timer somewhere other than its automatic spot. Automatic spots are fixed per timer type: below the Add to cart button for a product timer, across the top or bottom of the page for a bar, at the top of the page content for a landing timer, and at the top of the cart page and cart drawer for a cart timer.

Turning on the app embed

The app Home shows whether the embed is on in your live theme, with a button that opens the theme editor at App embeds with ours selected. Turn it on and save the theme. There is nothing to configure on it for most stores. Its one setting, a cart drawer selector, is only for a theme whose cart drawer the cart timer does not find on its own.

Placing a timer with the app block

In the timer Placement tab, choose Custom position, then save or publish. The tab then shows the Timer ID and an Add app block button. The button opens the theme editor on the right page type, a product page for a product timer, a collection page for a landing timer, the home page for a bar, and the cart for a cart timer, with the block being added. Paste the Timer ID into the block, move the block where you want it, and save.

A block can also hold a timer that keeps an automatic placement. It then shows only on pages that match the placement, and the timer is skipped at its automatic spot on that page, so it never shows twice. In the theme editor an empty block shows a short hint explaining why. Only you see it.

Getting a timer on the page, in four steps.

Turn on the app embed

From the button on the app Home. Save the theme. This is required for every timer type except email.

Create and publish a timer

In the app. A timer in an automatic placement is on the storefront once it is published and running.

For a custom position, add the block

Placement tab, Add app block. Paste the Timer ID into the block and save the theme.

Check the live page

Open it in a normal browser window and on a phone, not only in the theme editor preview.

Settings reference

App embed

On for any storefront timer to show. With it off, no timer shows and nothing else on the page changes.

Cart drawer selector

Optional, on the app embed. Only for a theme whose cart drawer the cart timer does not find, for example #my-cart-drawer.

Timer ID

Shown in the timer Placement tab after the first save, with a copy button. It is what the app block needs.

Custom position

A placement option for product, bar, landing, and cart timers. The timer shows only where a block holds its Timer ID.

Block with an automatic placement

Shows only on pages that match the timer placement. The automatic spot is skipped on those pages.

Theme editor hint

An empty block explains itself in the theme editor. Shoppers never see the hint.

If this does not work

The failures most likely on this procedure, with the check that resolves each one.

Installing TreStack Timer

What the Shopify permission screen will ask for and why, what an install changes on your store, and the one switch you turn on afterwards.

Development stores and theme previews

Design in the editor preview, test on a duplicate theme or a development store, and know which parts of the setup travel between themes and which do not.