Guide: Promo Content
Promotion Content is used to display coupon and promotional information to customers in the basket and at checkout. It can also surface a promotion as a menu card — making it browsable in the menu as if it were a regular product.
A promotion must be created in Byte Admin Portal first before it can be configured as a Promotion Content entry in Contentful.
Where You See It in the Front-End
Basket / Checkout — When a customer has a qualifying item in their cart, a promotion tile appears showing the promotion's Display Name, Description, and any Requirement Text (e.g. "Spend $20 to unlock this deal").
Menu card — Promotions can optionally appear as a card directly in the menu grid — with an image, title, and description — so customers can discover and add them to their basket without needing a coupon code.
What to Configure in Contentful
- In Contentful, navigate to the Promotion Content Type and open it
- Click Select from Yum to see a list of promotions created in Byte Admin Portal
- Select the promotion you want to configure
Configure Display Name — The name shown to the customer on the UI (e.g. "Zinger Box Deal"). Set this per locale.
Configure Description — Additional context displayed alongside the promotion (e.g. "Includes a Zinger Burger, regular fries, and a drink"). Set per locale.
Configure Requirement Text — Any conditions the customer must meet to receive the promotion (e.g. "Add a Large Meal to qualify"). Set per locale.
Configure Menu Card Image — Add an image to surface the promotion as a vertical menu card in the menu grid. Upload or select from existing media.
- Click Publish — or use the dropdown to schedule the promotion to go live at a specific date and time
Use Cases
Displaying a new coupon in checkout — Configure a promotion's copy and imagery so customers see it clearly in the basket when they're eligible to use it.
Launching a menu-visible deal — Add a menu card image to surface the promotion as a browsable item in the menu, making it discoverable without a promo code.
Time-limited campaigns — Use scheduled publishing to activate and deactivate a promotion's content in sync with a marketing campaign window.
Localised promotions — Set different Display Names and Descriptions per locale to tailor the promotion messaging to each market's language and tone.