Documentation

Enable the app embed

Your storefront needs the Pixel block turned on before shoppers can see a timer. This is a one-time setup per placement.

1. From the home page, find Embed Pixel on your storefront and click Enable the Pixel app embed — this opens your theme editor on the App embeds panel.
2. Find Pixel countdown timers at the top of the App embeds list and flip the toggle on.
3. Click Save in the top right.

That single switch powers the announcement bar and pop-up timers across your whole storefront. The other placements (homepage header, product, cart, floating) are added as their own theme blocks — see Placements below.

Placements

A placement is where a timer appears. Each is a theme block you enable once; then you can run any number of timers in it.

The announcement bar and pop-up are powered by the app embed. To add a homepage header, product or cart timer, open the theme editor on that page and add the matching Pixel block as a section block.

Creating a timer

Go to Timers → Create your first timer, choose a placement, and you land in the timer builder — a single screen with a live preview on the left and two tabs on the right: Content and Design.

Content tab

• Internal name — e.g. "Black Friday 2026". Shoppers never see this; it's just how you find the timer in your dashboard.
• Placement — confirm where the timer shows. You can change it later.
• Timing — choose fixed or evergreen and set when it ends.
• Message — your headline, with a live countdown token you can drop in.
• Expired message — optional text to show when the timer hits zero.
• Call-to-action — optional button that sends shoppers to your offer.

When everything looks right in the preview, click Create timer. It appears in your Timers list with a green Active status.

Fixed vs evergreen

Scheduling

For fixed timers you can optionally set a start time in addition to the end. The timer stays hidden until the start moment arrives, then appears automatically — so you can build a sale ahead of time and let it go live on its own.

Message & tokens

Write your message in plain text, then insert a variable to drop the live countdown into your copy. Click the variable chip in the editor, or type the token directly:

Hurry! Sale ends in {timer}

The {timer} token renders the ticking days/hours/minutes/seconds and updates once per second in the shopper's browser. You can also set an expired message that replaces the text when the countdown reaches zero.

Call-to-action button

Toggle on a CTA to add a button next to the timer that links to your offer (a collection, product, or any URL). When a shopper clicks it, Pixel records the click against the timer — this click is what later gets matched to an order for revenue attribution.

Page targeting

By default a timer shows everywhere its placement appears. Use page targeting to narrow that down with include/exclude URL patterns.

• Leave blank — show on every page (default).
• Include patterns — only show on URLs that match, e.g. /collections/sale.
• Exclude patterns — hide on URLs that match, e.g. /cart or /account/*.

Design & styling

The Design tab starts with a ready-made style, then lets you fine-tune everything. Full design customization is available on every plan, including Free.

Ready-made styles

What you can customize

• Color — single color, gradient, or background image; set background, text and ticker colors.
• Border & spacing — corner radius, padding and gaps.
• Layout & typography — inline or stacked, font choice, and how digits are styled.
• Position & dimensions — for the announcement bar, pin it to the top or bottom and set its size.

Every change updates live in the preview as you make it.

Revenue attribution

This is the heart of Pixel: connecting a timer to the revenue it actually drove. Here's the full chain.

1. Impression — when a shopper sees a timer, Pixel logs one impression per shopper, per timer, per page load (deduped so reloads don't inflate counts).
2. Click — when the shopper clicks the timer's CTA, Pixel records a click tagged with a privacy-safe shopper token (a cookie + localStorage value, no personal data).
3. Carry-through — that token is written to the cart so it rides all the way to checkout.
4. Order match — when the order is created, Pixel reads the token, finds the most recent unattributed click from your timers within a 7-day attribution window, and credits that click with the order's total revenue.

The result surfaces in your dashboard and analytics as attributed revenue — ranked per timer, so you can see which ones earn their keep.

Analytics dashboard

The analytics dashboard (available on Growth and Pro) shows per-day series and a per-timer breakdown:

• Impressions and clicks over time.
• Click-through rate (CTR) per timer.
• Attributed revenue per timer, so your best performers are obvious.

On Free and Starter you'll see a preview with an upgrade prompt instead of live data.

Email reports

In Settings, choose how Pixel keeps you informed. Each report summarizes revenue, orders, clicks and your top-performing timer.

• Daily snapshot — best for high-traffic stores. Pro
• Weekly nudge — stay on top of things. Growth & Pro
• Monthly recap — the bigger picture. Growth & Pro

Add the email address reports should go to and click Save settings. Want to see one immediately? Hit Send a test now.

Plans & billing

Every plan includes unlimited active timers and full design customization. Plans differ on placements and features. All billing is handled natively through Shopify and appears on your regular Shopify invoice.

• Every paid tier starts with a 7-day free trial — you aren't charged until it ends.
• Approve the subscription in Shopify's native checkout to start your trial.
• Once activated, a green banner confirms your plan, and the billing page shows your renewal and next charge date.
• Cancel anytime in one click from your Shopify Admin.

Privacy & data

Pixel keeps its data footprint deliberately small. It stores no customer PII only an opaque shopper token (a cookie + localStorage value) plus order IDs and totals needed for attribution. Storefront requests are signed and verified server-side, and merchant access tokens are encrypted at rest.

Troubleshooting

My placement says "Block missing"

The timer exists but the storefront block isn't enabled. For the announcement bar or pop-up, enable the app embed. For homepage header, product or cart, add the matching block in the theme editor for that page, then click Save.

My timer isn't showing

• Confirm the timer status is Active (not paused) in the Timers list.
• Confirm the block/embed is enabled and the theme is saved.
• Check page targeting an include/exclude rule may be hiding it on the page you're viewing.
• For a scheduled timer, confirm the start time has passed.

Impressions and clicks are at zero

This is normal right after creating a timer counts only start once the block is live on the storefront and real shoppers (or you, on the live store) load the page.

Revenue isn't being attributed

Attribution requires a shopper to click the CTA, then place an order within 7 days. Make sure the timer has a CTA enabled, then watch the next order match.