Promotions & Offers
Run sales without redeploying. Promotions carry their code, discount type, and start and end times, while banners bind each campaign to specific storefront placements with their own artwork and colors. Your frontend reads active promotions by date and placement, and campaigns switch on and off by themselves.
What's inside
Every content type ships pre-configured with typed fields, validation and relationships.
Promotion
A campaign with discount mechanics, validity window, and terms.titleTextrequiredCampaign name, e.g. Summer Sale 2026slugSlugrequiredIdentifier for campaign landing pages and analyticssummaryTextrequiredShort teaser shown on cards and bannersdetailsRichTextoptionalFull offer terms and conditionspromo_codeTextoptionalCode customers enter at checkout, e.g. SUMMER20discount_typeEnumrequiredMechanic, options: percentage, fixed_amount, bogo, free_shipping, free_giftdiscount_valueTextoptionalPercent or amount as a string, e.g. 20 or 15.00starts_atDateTimerequiredWhen the offer becomes visible and validends_atDateTimerequiredWhen the offer expires and banners hidecta_linkLinkoptionalDestination for the call to action, e.g. a sale collectionhero_imageImageoptionalKey visual for the campaign landing pageactiveBooleanoptionalManual kill switch that overrides the date windowBanner
A placement-specific creative that advertises a promotion somewhere in the storefront.nameTextrequiredInternal name, e.g. Summer Sale homepage heroslugSlugrequiredStable identifier for the banner slotplacementEnumrequiredSlot, options: homepage_hero, category_page, product_page, cart, checkoutheadlineTextrequiredMain line of copy rendered on the bannerimageImageoptionalBanner artwork sized for the placementbackground_colorColoroptionalFallback or brand background behind the artworkpromotionReferencerequiredCampaign this banner advertises (references Promotion)cta_labelTextoptionalButton text, e.g. Shop the saleShips with sample data
Install the blueprint and explore it with realistic example records.
20 percent off sitewide with code SUMMER20, running June 15 to June 30
Homepage hero banner with key visual and Shop the sale CTA, linked to Summer Sale 2026
Free shipping promotion with no code required, shown only on cart and checkout placements
Why this blueprint
Start and end datetimes let offers appear and expire on schedule, with a manual kill switch for emergencies.
Each banner declares its storefront slot, so one campaign fans out to hero, cart, and checkout with tailored creative.
Marketers launch, tweak, and retire offers entirely in the CMS while the frontend just reads what is active.
Built for
- An e-commerce team scheduling Black Friday banners across homepage, cart, and checkout weeks ahead
- A marketer launching a flash sale with a promo code and pulling it early with the active toggle
- A regional team running localized offers by pointing placements at different promotions
- A CRM team reusing promotion records to keep email and site messaging consistent
More in Commerce & Marketing
A complete product catalog with categories and brands, ready to power any headless storefront.
Collect and publish customer quotes with ratings, sources, and linked company profiles.
Structured pricing tiers, feature matrices, and FAQs that keep your pricing page in sync.
Start with the Promotions & Offers blueprint
Install it in one click, explore the sample data, then adapt every field to your needs.