Toast (pop-up)
Updated Oct 1, 20262 min read
On this page (6)
The toast is a small floating message that appears over the page when a Hype campaign is active — for example, to confirm that a discount has been applied. It works with every discount type and, like the announcement bar, it needs no App block ID.
Turn it on
- Open the campaign's Blocks page and select the Storewide tab.
- Click Add campaign block and choose Toast (Pop-up).
- Write the message, pick an icon, and save.
- Go to Online Store → Themes → Customize → App embeds and enable Hype: Toast. The Hype: Discounts embed must be enabled too.
Settings in the Hype admin
- Message — the toast text. You can insert
{{discount_code}}; see Variables you can use in block text. - Icon — a filled or outlined icon, an emoji, or none.
- Show once when first applied — off by default. When on, the toast shows only once per shopper for that campaign. The browser remembers this in local storage, so clearing site data makes it show again.
- Auto close toast — when on, the toast dismisses itself instead of waiting for the shopper to close it.
Settings in the theme editor
Open App embeds → Hype: Toast.
| Setting | Options | Default |
|---|---|---|
| Background style | Solid color (Default), Magic gradient, Electric horizon, Neon sunset, Tropical burst, Cyber fusion, Vibrant dawn, Laser pulse, Digital candy, Future glow | Solid color |
| Background color | Used only when Background style is Solid color | #000 |
| Text color | #fff | |
| Text size | 4px to 40px | 14px |
| Block padding | Vertical padding, in pixels | 8 |
| Inline padding | Horizontal padding, in pixels | 15 |
| Border radius | 0px to 100px | 50px |
| Toast position | Top left, Top center, Top right, Bottom left, Bottom center, Bottom right | Bottom center |
| Font weight | Regular, Bold | Regular |
| Toast width | Fit, Medium, Full | Fit |
| Content alignment | Left, Center | Center |
| Custom CSS | Extra styles for the toast | empty |
| Custom JavaScript | Extra script for the toast | empty |
Previewing it
Inside the Shopify theme editor the toast renders with placeholder content — Success! You've Unlocked Extra Rewards with a confetti icon — so you can position and style it with no campaign running. On the live storefront it only appears for a shopper who has an active campaign with a toast block.
When it does not appear
- The Hype: Discounts embed or the Hype: Toast embed is off.
- The campaign is not active, or the shopper's market is not targeted.
- Show once when first applied is on and this browser has already seen it for this campaign.
- Campaign data is cached for up to 10 minutes after a change; see Clearing the cache.
Only one toast is rendered per campaign, even if the campaign returns several discount strategies.
Related
Was this article helpful?
Related articles
Still stuck?
Ask a follow-up and we'll see it came from “Toast (pop-up)”.
Opens chat with your question and a link to this article.