docs / templates

Templates and fields

Fetched live from GET /v1/templates (or the public catalogue). Image fields accept a public https PNG or JPEG, or a built-in sample such as sample:mug.

Article card article-card v1

Blog or news post announcement for link previews and feeds. Sizes: link (1200×630), square (1080×1080).

`site_name`required	Site or brand name, up to 40 characters
`logo_url`	Logo. Square PNG or JPEG works best. https URL or a built-in sample.
`category`	Category, up to 32 characters. Small label above the headline
`headline`required	Headline, up to 120 characters
`subtitle`	Subtitle, up to 200 characters
`author`	Author, up to 48 characters
`published`	Date text, up to 32 characters. Shown as written, e.g. "31 Oct 2026"
`brand_color`	Brand colour. Default #1F5C4A
`theme`	Theme. Default paper. One of: paper, ink

Product card product-card v1

New product or listing with photo, price and call to action. Sizes: square (1080×1080), portrait (1080×1350).

`brand_name`required	Brand name, up to 40 characters
`logo_url`	Logo. Square PNG or JPEG works best. https URL or a built-in sample.
`product_name`required	Product name, up to 80 characters
`price`required	Price, up to 24 characters. Shown as written, e.g. "₹1,499" or "$24"
`compare_at_price`	Was price, up to 24 characters. Shown struck through
`badge`	Badge, up to 20 characters. e.g. "New" or "Just listed"
`description`	Short description, up to 140 characters
`image_url`	Photo URL. Public https JPEG or PNG up to 5 MB, or a built-in sample such as sample:mug.
`cta`	Call to action, up to 28 characters. Default Shop now
`brand_color`	Brand colour. Default #B4441B
`background`	Background. Default light. One of: light, tinted

Announcement / offer card announcement-card v1

Weekly offer, event or news announcement with a large headline. Sizes: square (1080×1080), story (1080×1920).

`brand_name`required	Brand name, up to 40 characters
`logo_url`	Logo. Square PNG or JPEG works best. https URL or a built-in sample.
`kicker`	Kicker, up to 28 characters. Short line above the headline, e.g. "This week only"
`offer`	Offer, up to 16 characters. Large text, e.g. "30% off"
`headline`required	Headline, up to 90 characters
`details`	Details, up to 180 characters
`date_text`	Date or time, up to 48 characters
`cta`	Call to action, up to 32 characters
`brand_color`	Brand colour. Default #3A2F8C
`style`	Style. Default bold. One of: bold, outline

Event card event-card v1

Workshop, launch or meetup with date, time and place. Sizes: square (1080×1080), story (1080×1920).

`organiser`required	Organiser, up to 40 characters
`logo_url`	Logo. Square PNG or JPEG works best. https URL or a built-in sample.
`title`required	Event title, up to 80 characters
`day`required	Day, up to 3 characters. Day of the month, e.g. "14"
`month`required	Month, up to 9 characters. e.g. "Nov" or "November"
`time`	Time, up to 32 characters. Shown as written, e.g. "6:30 – 9 pm"
`venue`	Venue, up to 60 characters
`image_url`	Photo. https URL or a built-in sample such as sample:venue.
`cta`	Call to action, up to 28 characters. Default Reserve a seat
`brand_color`	Brand colour. Default #1F6F5C

Quote card quote-card v1

Customer review, testimonial or pull quote with the person behind it. Sizes: square (1080×1080), link (1200×630).

`quote`required	Quote, up to 220 characters. Only publish quotes the person agreed to share.
`author`required	Person, up to 48 characters
`role`	Role or place, up to 60 characters
`avatar_url`	Photo. Square photo. https URL or sample:avatar.
`brand_name`required	Brand name, up to 40 characters
`brand_color`	Brand colour. Default #B4441B
`style`	Style. Default light. One of: light, dark