Commerce & Marketing · Blueprint
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.
- content types
- 2
- fields
- 20
- sample records
- 3
Schema
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.
12 fields
| title | Text | Campaign name, e.g. Summer Sale 2026 |
| slug | Slug | Identifier for campaign landing pages and analytics |
| summary | Text | Short teaser shown on cards and banners |
| details | RichText | Full offer terms and conditions |
| promo_code | Text | Code customers enter at checkout, e.g. SUMMER20 |
| discount_type | Enum | Mechanic, options: percentage, fixed_amount, bogo, free_shipping, free_gift |
| discount_value | Text | Percent or amount as a string, e.g. 20 or 15.00 |
| starts_at | DateTime | When the offer becomes visible and valid |
| ends_at | DateTime | When the offer expires and banners hide |
| cta_link | Link | Destination for the call to action, e.g. a sale collection |
| hero_image | Image | Key visual for the campaign landing page |
| active | Boolean | Manual kill switch that overrides the date window |
Banner
A placement-specific creative that advertises a promotion somewhere in the storefront.
8 fields
| name | Text | Internal name, e.g. Summer Sale homepage hero |
| slug | Slug | Stable identifier for the banner slot |
| placement | Enum | Slot, options: homepage_hero, category_page, product_page, cart, checkout |
| headline | Text | Main line of copy rendered on the banner |
| image | Image | Banner artwork sized for the placement |
| background_color | Color | Fallback or brand background behind the artwork |
| promotion | Reference | Campaign this banner advertises (references Promotion) |
| cta_label | Text | Button text, e.g. Shop the sale |
REST API
Promotion, as JSON.
Each content type of the blueprint is served by the REST API, with filtering, sorting, search and pagination.
Explore the API docs{
"id": 1,
"status": "published",
"data": {
"title": "Summer Sale 2026",
"slug": "summer-sale-2026",
"summary": "…",
"details": "<p>…</p>",
"promo_code": "…",
"discount_type": "…",
"discount_value": "…",
"starts_at": "2026-09-22T09:00:00Z",
"ends_at": "2026-09-22T09:00:00Z"
}
}Sample data
Ships with sample data
Install the blueprint and explore it with realistic example records.
- Sample
Summer Sale 2026
20 percent off sitewide with code SUMMER20, running June 15 to June 30
- Sample
Summer Sale homepage hero
Homepage hero banner with key visual and Shop the sale CTA, linked to Summer Sale 2026
- Sample
Free shipping September
Free shipping promotion with no code required, shown only on cart and checkout placements
Features
Why this blueprint
- Campaigns on a timer Start and end datetimes let offers appear and expire on schedule, with a manual kill switch for emergencies.
- Placement-aware banners Each banner declares its storefront slot, so one campaign fans out to hero, cart, and checkout with tailored creative.
- No-deploy merchandising Marketers launch, tweak, and retire offers entirely in the CMS while the frontend just reads what is active.
Use cases
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
Related
More in Commerce & Marketing
-
E-commerce Catalog
A complete product catalog with categories and brands, ready to power any headless storefront.
-
Testimonials
Collect and publish customer quotes with ratings, sources, and linked company profiles.
-
Pricing Plans
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.
No credit card required · 3 months free trial · Cancel anytime