Composition, Bento grid 1.0.0
| Template | Composition, tpl_5ff7bb6d3539 |
|---|---|
| Variant | Bento grid |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 9 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
One whole split into two to eight parts, as a donut or a 100% bar with a legend of every part, its share of the whole and its value: the parts fill the whole one after another in the order sent, each share counting up. metaData is the post's title, descriptions and hashtags and is never drawn.
| Field | Type | Required | Limit | What it is |
|---|---|---|---|---|
clipData | group | yes | Clip data: Everything drawn: a kicker, the title, the shape, what is written beside each part, the parts with their labels and values, the whole's total, a line of context, the source and the look. | |
clipData.kicker | text | up to 20 characters | Kicker: A word or two above the title, such as GRID MIX or BUDGET. | |
clipData.title | text | yes | up to 80 characters | Title: What the whole is and when. |
clipData.shape | enum | donut, bar | Shape: A donut with the total in its middle, or a 100% bar with the total over it. | |
clipData.show | enum | both, share, value | Written beside each part: Beside each part: its share of the whole, its value, or both. A share is worked out from the values: where the values add up to 100, each share is its value exactly; otherwise each share is rounded down to one decimal, and a line under the legend says what they add up to when that is not 100. | |
clipData.prefix | text | up to 3 characters | Prefix: Written before every value, such as a currency sign. | |
clipData.unit | text | up to 12 characters | Unit: Written after every value: TWh, people, bn. | |
clipData.totalLabel | text | up to 24 characters | Total: What the whole is called, written with the sum of the parts. Left empty, no total is written. | |
clipData.parts | list | yes | at least 2, up to 8 | Parts: In the order they fill the whole, which is the order meant (often largest first). Two to eight; each value is its part of the whole, never below nought. The clip runs 8 to 10 seconds with the parts. |
clipData.parts[] | group | Part | ||
clipData.parts[].label | text | yes | up to 28 characters | Label |
clipData.parts[].value | number | yes | from 0, 4 decimals | Value |
clipData.note | text | up to 120 characters | Context: One or two lines under the shape. | |
clipData.source | text | up to 60 characters | Source | |
clipData.look | group | Look: How the clip looks and moves within its style. The same five switches in every format of the collections. Leave a switch out, or set it to the style's own, and the style decides. | ||
clipData.look.theme | enum | auto, brand, light, dark, bold | Theme: The style's own choice; your brand's own colours and background; a light or dark page tinted with your brand colour; or your brand colour as the page. | |
clipData.look.pace | enum | auto, calm, standard, punchy | Pace: How things arrive: the style's own rhythm, calm fades, a standard rhythm, or punchy slams and cuts. | |
clipData.look.corners | enum | auto, square, soft, round | Corners: The shape of cards, panels and marks. | |
clipData.look.align | enum | auto, start, centre | Text alignment: Where the text lines up. | |
clipData.look.logo | enum | auto, free | Logo: The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose. | |
metaData | group | Meta data: Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data. | ||
metaData.title | text | up to 100 characters | Title: Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes. | |
metaData.captionTiny | text | up to 200 characters | Tiny description (Pinterest, Threads, X): Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionShort | text | up to 500 characters | Short description (Telegram, Threema, WeChat, WhatsApp): Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionMedium | text | up to 1500 characters | Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok): Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionLong | text | up to 4000 characters | Long description (Facebook Feed, YouTube): Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.hashtags | list | up to 15 | Hashtags: Written without the #. Up to 15, which every platform takes. | |
metaData.hashtags[] | text | up to 60 characters | Hashtag |
locales carries other languages: under each language code, the parts of clipData and metaData that differ, laid over the default, so a language with no copy still renders.
A picture is always a file from your media library: media:// followed by its id or its name.
Anything the table does not list is refused, and so is anything over its limit, with a 422 that
names the field.
The JSON Schema
{
"type": "object",
"properties": {
"clipData": {
"type": "object",
"properties": {
"kicker": {
"type": "string",
"maxLength": 20,
"title": "Kicker",
"description": "A word or two above the title, such as GRID MIX or BUDGET."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What the whole is and when."
},
"shape": {
"type": "string",
"enum": [
"donut",
"bar"
],
"title": "Shape",
"description": "A donut with the total in its middle, or a 100% bar with the total over it.",
"enumNames": [
"Donut",
"100% bar"
]
},
"show": {
"type": "string",
"enum": [
"both",
"share",
"value"
],
"title": "Written beside each part",
"description": "Beside each part: its share of the whole, its value, or both. A share is worked out from the values: where the values add up to 100, each share is its value exactly; otherwise each share is rounded down to one decimal, and a line under the legend says what they add up to when that is not 100.",
"enumNames": [
"Share and value",
"Share only",
"Value only"
]
},
"prefix": {
"type": "string",
"maxLength": 3,
"title": "Prefix",
"description": "Written before every value, such as a currency sign."
},
"unit": {
"type": "string",
"maxLength": 12,
"title": "Unit",
"description": "Written after every value: TWh, people, bn."
},
"totalLabel": {
"type": "string",
"maxLength": 24,
"title": "Total",
"description": "What the whole is called, written with the sum of the parts. Left empty, no total is written."
},
"parts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Label"
},
"value": {
"type": "number",
"minimum": 0,
"title": "Value"
}
},
"required": [
"label",
"value"
],
"additionalProperties": false,
"title": "Part"
},
"minItems": 2,
"maxItems": 8,
"title": "Parts",
"description": "In the order they fill the whole, which is the order meant (often largest first). Two to eight; each value is its part of the whole, never below nought. The clip runs 8 to 10 seconds with the parts."
},
"note": {
"type": "string",
"maxLength": 120,
"title": "Context",
"description": "One or two lines under the shape."
},
"source": {
"type": "string",
"maxLength": 60,
"title": "Source"
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"auto",
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "The style's own choice; your brand's own colours and background; a light or dark page tinted with your brand colour; or your brand colour as the page.",
"enumNames": [
"The style's own",
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"auto",
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: the style's own rhythm, calm fades, a standard rhythm, or punchy slams and cuts.",
"enumNames": [
"The style's own",
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"auto",
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, panels and marks.",
"enumNames": [
"The style's own",
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"auto",
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"The style's own",
"At the start of the line",
"Centred"
]
},
"logo": {
"type": "string",
"enum": [
"auto",
"free"
],
"title": "Logo",
"description": "The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.",
"enumNames": [
"The style's own",
"As it is, no plate or crop"
]
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves within its style. The same five switches in every format of the collections. Leave a switch out, or set it to the style's own, and the style decides."
}
},
"required": [
"title",
"parts"
],
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn: a kicker, the title, the shape, what is written beside each part, the parts with their labels and values, the whole's total, a line of context, the source and the look."
},
"metaData": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"title": "Title",
"description": "Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes."
},
"captionTiny": {
"type": "string",
"maxLength": 200,
"title": "Tiny description (Pinterest, Threads, X)",
"description": "Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionShort": {
"type": "string",
"maxLength": 500,
"title": "Short description (Telegram, Threema, WeChat, WhatsApp)",
"description": "Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionMedium": {
"type": "string",
"maxLength": 1500,
"title": "Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok)",
"description": "Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionLong": {
"type": "string",
"maxLength": 4000,
"title": "Long description (Facebook Feed, YouTube)",
"description": "Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"hashtags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"title": "Hashtag"
},
"maxItems": 15,
"title": "Hashtags",
"description": "Written without the #. Up to 15, which every platform takes."
}
},
"additionalProperties": false,
"title": "Meta data",
"description": "Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data."
},
"locales": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"clipData": {
"type": "object",
"properties": {
"kicker": {
"type": "string",
"maxLength": 20,
"title": "Kicker",
"description": "A word or two above the title, such as GRID MIX or BUDGET."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What the whole is and when."
},
"shape": {
"type": "string",
"enum": [
"donut",
"bar"
],
"title": "Shape",
"description": "A donut with the total in its middle, or a 100% bar with the total over it.",
"enumNames": [
"Donut",
"100% bar"
]
},
"show": {
"type": "string",
"enum": [
"both",
"share",
"value"
],
"title": "Written beside each part",
"description": "Beside each part: its share of the whole, its value, or both. A share is worked out from the values: where the values add up to 100, each share is its value exactly; otherwise each share is rounded down to one decimal, and a line under the legend says what they add up to when that is not 100.",
"enumNames": [
"Share and value",
"Share only",
"Value only"
]
},
"prefix": {
"type": "string",
"maxLength": 3,
"title": "Prefix",
"description": "Written before every value, such as a currency sign."
},
"unit": {
"type": "string",
"maxLength": 12,
"title": "Unit",
"description": "Written after every value: TWh, people, bn."
},
"totalLabel": {
"type": "string",
"maxLength": 24,
"title": "Total",
"description": "What the whole is called, written with the sum of the parts. Left empty, no total is written."
},
"parts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Label"
},
"value": {
"type": "number",
"minimum": 0,
"title": "Value"
}
},
"required": [
"label",
"value"
],
"additionalProperties": false,
"title": "Part"
},
"minItems": 2,
"maxItems": 8,
"title": "Parts",
"description": "In the order they fill the whole, which is the order meant (often largest first). Two to eight; each value is its part of the whole, never below nought. The clip runs 8 to 10 seconds with the parts."
},
"note": {
"type": "string",
"maxLength": 120,
"title": "Context",
"description": "One or two lines under the shape."
},
"source": {
"type": "string",
"maxLength": 60,
"title": "Source"
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"auto",
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "The style's own choice; your brand's own colours and background; a light or dark page tinted with your brand colour; or your brand colour as the page.",
"enumNames": [
"The style's own",
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"auto",
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: the style's own rhythm, calm fades, a standard rhythm, or punchy slams and cuts.",
"enumNames": [
"The style's own",
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"auto",
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, panels and marks.",
"enumNames": [
"The style's own",
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"auto",
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"The style's own",
"At the start of the line",
"Centred"
]
},
"logo": {
"type": "string",
"enum": [
"auto",
"free"
],
"title": "Logo",
"description": "The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.",
"enumNames": [
"The style's own",
"As it is, no plate or crop"
]
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves within its style. The same five switches in every format of the collections. Leave a switch out, or set it to the style's own, and the style decides."
}
},
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn: a kicker, the title, the shape, what is written beside each part, the parts with their labels and values, the whole's total, a line of context, the source and the look."
},
"metaData": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"title": "Title",
"description": "Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes."
},
"captionTiny": {
"type": "string",
"maxLength": 200,
"title": "Tiny description (Pinterest, Threads, X)",
"description": "Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionShort": {
"type": "string",
"maxLength": 500,
"title": "Short description (Telegram, Threema, WeChat, WhatsApp)",
"description": "Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionMedium": {
"type": "string",
"maxLength": 1500,
"title": "Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok)",
"description": "Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionLong": {
"type": "string",
"maxLength": 4000,
"title": "Long description (Facebook Feed, YouTube)",
"description": "Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"hashtags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"title": "Hashtag"
},
"maxItems": 15,
"title": "Hashtags",
"description": "Written without the #. Up to 15, which every platform takes."
}
},
"additionalProperties": false,
"title": "Meta data",
"description": "Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data."
}
},
"additionalProperties": false
},
"propertyNames": {
"enum": [
"aa",
"ab",
"ae",
"af",
"ak",
"am",
"an",
"ar",
"as",
"av",
"ay",
"az",
"ba",
"be",
"bg",
"bi",
"bm",
"bn",
"bo",
"br",
"bs",
"ca",
"ce",
"ch",
"co",
"cr",
"cs",
"cu",
"cv",
"cy",
"da",
"de",
"dv",
"dz",
"ee",
"el",
"en",
"eo",
"es",
"et",
"eu",
"fa",
"ff",
"fi",
"fj",
"fo",
"fr",
"fy",
"ga",
"gd",
"gl",
"gn",
"gu",
"gv",
"ha",
"he",
"hi",
"ho",
"hr",
"ht",
"hu",
"hy",
"hz",
"ia",
"id",
"ie",
"ig",
"ii",
"ik",
"io",
"is",
"it",
"iu",
"ja",
"jv",
"ka",
"kg",
"ki",
"kj",
"kk",
"kl",
"km",
"kn",
"ko",
"kr",
"ks",
"ku",
"kv",
"kw",
"ky",
"la",
"lb",
"lg",
"li",
"ln",
"lo",
"lt",
"lu",
"lv",
"mg",
"mh",
"mi",
"mk",
"ml",
"mn",
"mr",
"ms",
"mt",
"my",
"na",
"nb",
"nd",
"ne",
"ng",
"nl",
"nn",
"no",
"nr",
"nv",
"ny",
"oc",
"oj",
"om",
"or",
"os",
"pa",
"pi",
"pl",
"ps",
"pt",
"qu",
"rm",
"rn",
"ro",
"ru",
"rw",
"sa",
"sc",
"sd",
"se",
"sg",
"si",
"sk",
"sl",
"sm",
"sn",
"so",
"sq",
"sr",
"ss",
"st",
"su",
"sv",
"sw",
"ta",
"te",
"tg",
"th",
"ti",
"tk",
"tl",
"tn",
"to",
"tr",
"ts",
"tt",
"tw",
"ty",
"ug",
"uk",
"ur",
"uz",
"ve",
"vi",
"vo",
"wa",
"wo",
"xh",
"yi",
"yo",
"za",
"zh",
"zu",
"zh-CN",
"zh-TW",
"pt-BR"
]
}
}
},
"required": [
"clipData"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
Ask Reelwire for the same document yourself, without signing in:
curl "http://localhost:4000/v1/formats/template/tpl_5ff7bb6d3539?variant=Bento%20grid&version=1.0.0"
Delivery JSON
Your own system sends this to one of your streams, POST /v1/stream, and every channel listening to
that stream draws it with its template. data is the document described above; a stream with an
empty field map passes it to the template unchanged. Try it first on POST /v1/stream/validate,
which answers the same without publishing anything. Streams and feeds
explains the rest, including how to map a document of your own shape instead.
{
"streamId": "st_your_stream_id",
"eventId": "01M2SQMKK3G1NVFXV31DCBVB95",
"occurredAt": "2026-09-23T07:00:00Z",
"locale": "en",
"data": {
"clipData": {
"kicker": "Grid mix",
"title": "Where the grid's power came from in September",
"shape": "donut",
"show": "both",
"prefix": "",
"unit": "TWh",
"totalLabel": "Generated",
"parts": [
{
"label": "Wind",
"value": 7.64
},
{
"label": "Solar",
"value": 4.28
},
{
"label": "Gas",
"value": 2.92
},
{
"label": "Hydro",
"value": 2.58
},
{
"label": "Nuclear",
"value": 1.96
},
{
"label": "Biomass and other sources",
"value": 0.62
}
],
"note": "Wind and solar together supplied more than half of the grid's power for the first time in a September",
"source": "Grid operator, monthly generation report",
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto",
"logo": "auto"
}
},
"metaData": {
"title": "Wind and solar supplied more than half of the grid's power in September",
"captionTiny": "Wind and solar supplied 59.6% of the grid's power in September, more than half for the first time in a September.",
"captionShort": "Wind supplied 38.2% of the grid's power in September and solar 21.4%, together more than half for the first time in a September. Gas came third at 14.6%, ahead of hydro and nuclear. In all, 20 TWh were generated.",
"captionMedium": "Wind supplied 38.2% of the grid's power in September and solar 21.4%, together more than half of all generation for the first time in a September. Gas came third at 14.6%, ahead of hydro at 12.9% and nuclear at 9.8%. Biomass and other sources made up the remaining 3.1%. In all, 20 TWh were generated during the month, according to the grid operator's monthly report.",
"captionLong": "Wind supplied 38.2% of the grid's power in September and solar 21.4%, together more than half of all generation for the first time in a September. A windy last week and long sunny afternoons did most of the work. Gas came third at 14.6%, ahead of hydro at 12.9% and nuclear at 9.8%, while biomass and other sources made up the remaining 3.1%. In all, 20 TWh were generated during the month, according to the grid operator's monthly generation report. Each share is that source's part of the month's total.",
"hashtags": [
"energy",
"renewables",
"gridmix"
]
}
}
}
The delivery names no version: which build draws it is the channel's choice, the newest of its
variant or the one it is pinned to. eventId is a ULID you make once per event: sending the same
one again changes nothing. occurredAt is when the thing happened, not when you sent it. locale
is the language of the text in data, and data.locales carries other languages beside it.