Number grid, Swiss grid 1.0.0
| Template | Number grid, tpl_06dc2554e5ac |
|---|---|
| Variant | Swiss grid |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 10 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
Two to sixteen figures in a grid of tiles, up to eight to a page, each counting up to its value one after another, with its label, unit and change. For a commodity board, a city in numbers, the week's figures. 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, what the figures are, the figures with their labels, units and changes, the source and the look. | |
clipData.kicker | text | up to 20 characters | Kicker: A word above the title, such as AT THE CLOSE or IN NUMBERS. | |
clipData.title | text | yes | up to 80 characters | Title: What the figures are, together. |
clipData.items | list | yes | at least 2, up to 16 | Figures: Two to sixteen, drawn in the order sent, left to right and top to bottom, up to eight to a page: past eight they turn a page. Each adds under a second. |
clipData.items[] | group | Figure | ||
clipData.items[].label | text | up to 24 characters | Label: What the figure is. Left out, the tile shows the figure alone. | |
clipData.items[].value | number | yes | 4 decimals | Value |
clipData.items[].prefix | text | up to 3 characters | Prefix: Written before the value, such as a currency sign. | |
clipData.items[].unit | text | up to 12 characters | Unit: Written under the value: a barrel, km, people. | |
clipData.items[].change | number | 4 decimals | Change: Shown in green or red beside the unit. Left out, none is shown. | |
clipData.items[].changeUnit | text | up to 6 characters | Change unit: Written after the change. Left out, a percent sign. | |
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 above the title, such as AT THE CLOSE or IN NUMBERS."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What the figures are, together."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 24,
"title": "Label",
"description": "What the figure is. Left out, the tile shows the figure alone."
},
"value": {
"type": "number",
"title": "Value"
},
"prefix": {
"type": "string",
"maxLength": 3,
"title": "Prefix",
"description": "Written before the value, such as a currency sign."
},
"unit": {
"type": "string",
"maxLength": 12,
"title": "Unit",
"description": "Written under the value: a barrel, km, people."
},
"change": {
"type": "number",
"title": "Change",
"description": "Shown in green or red beside the unit. Left out, none is shown."
},
"changeUnit": {
"type": "string",
"maxLength": 6,
"title": "Change unit",
"description": "Written after the change. Left out, a percent sign."
}
},
"required": [
"value"
],
"additionalProperties": false,
"title": "Figure"
},
"minItems": 2,
"maxItems": 16,
"title": "Figures",
"description": "Two to sixteen, drawn in the order sent, left to right and top to bottom, up to eight to a page: past eight they turn a page. Each adds under a second."
},
"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",
"items"
],
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn: a kicker, what the figures are, the figures with their labels, units and changes, 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 above the title, such as AT THE CLOSE or IN NUMBERS."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What the figures are, together."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 24,
"title": "Label",
"description": "What the figure is. Left out, the tile shows the figure alone."
},
"value": {
"type": "number",
"title": "Value"
},
"prefix": {
"type": "string",
"maxLength": 3,
"title": "Prefix",
"description": "Written before the value, such as a currency sign."
},
"unit": {
"type": "string",
"maxLength": 12,
"title": "Unit",
"description": "Written under the value: a barrel, km, people."
},
"change": {
"type": "number",
"title": "Change",
"description": "Shown in green or red beside the unit. Left out, none is shown."
},
"changeUnit": {
"type": "string",
"maxLength": 6,
"title": "Change unit",
"description": "Written after the change. Left out, a percent sign."
}
},
"required": [
"value"
],
"additionalProperties": false,
"title": "Figure"
},
"minItems": 2,
"maxItems": 16,
"title": "Figures",
"description": "Two to sixteen, drawn in the order sent, left to right and top to bottom, up to eight to a page: past eight they turn a page. Each adds under a second."
},
"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, what the figures are, the figures with their labels, units and changes, 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_06dc2554e5ac?variant=Swiss%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": "At the close",
"title": "Oil, metals, gas and grain: where commodity prices closed on Wednesday",
"items": [
{
"unit": "a barrel",
"label": "Brent crude",
"value": 82.43,
"change": 1.2,
"prefix": "$"
},
{
"unit": "an ounce",
"label": "Gold",
"value": 2388.15,
"change": -0.4,
"prefix": "$"
},
{
"unit": "per MMBtu",
"label": "Natural gas",
"value": 2.71,
"change": 3.1,
"prefix": "$"
},
{
"unit": "a pound",
"label": "Copper",
"value": 4.12,
"change": 0.8,
"prefix": "$"
},
{
"unit": "an ounce",
"label": "Silver",
"value": 28.35,
"change": -1.1,
"prefix": "$"
},
{
"unit": "a bushel",
"label": "Wheat, December futures",
"value": 5.64,
"change": 0,
"prefix": "$",
"changeUnit": "%"
}
],
"source": "Northwind Exchange settlement prices, Wednesday 30 September",
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto",
"logo": "auto"
}
},
"metaData": {
"title": "Commodities at the close: Brent at 82.43 dollars, gold at 2,388.15, gas up 3.1 percent on the day",
"captionTiny": "Commodities at Wednesday's close: Brent 82.43 dollars a barrel, up 1.2 percent. Gold 2,388.15, down 0.4 percent. Natural gas up 3.1 percent. Copper, silver and wheat in the clip.",
"captionShort": "Where commodity prices closed on Wednesday. Brent crude rose 1.2 percent to 82.43 dollars a barrel and natural gas 3.1 percent to 2.71 dollars, after an outage on the Halvard offshore pipeline. Gold slipped 0.4 percent to 2,388.15 dollars an ounce and silver 1.1 percent to 28.35. Copper gained 0.8 percent to 4.12 dollars a pound. December wheat was unchanged at 5.64 dollars a bushel.",
"captionMedium": "Where commodity prices closed on Wednesday.\n\nEnergy led the day. Brent crude rose 1.2 percent to 82.43 dollars a barrel and natural gas 3.1 percent to 2.71 dollars per million British thermal units, after an unplanned outage on the Halvard offshore pipeline cut supply for several hours. Traders also pointed to a smaller rise in fuel stocks than expected.\n\nPrecious metals eased. Gold slipped 0.4 percent to 2,388.15 dollars an ounce and silver 1.1 percent to 28.35, as the dollar firmed ahead of Thursday's rate decision.\n\nCopper gained 0.8 percent to 4.12 dollars a pound on hopes of stronger demand from construction. December wheat was unchanged at 5.64 dollars a bushel, with the harvest in the southern growing regions on schedule.\n\nPrices are the exchange's settlement prices for the front month, except wheat, which is the December contract. Nothing in this clip is investment advice.",
"captionLong": "Where commodity prices closed on Wednesday.\n\nEnergy led the day. Brent crude rose 1.2 percent to 82.43 dollars a barrel and natural gas 3.1 percent to 2.71 dollars per million British thermal units, after an unplanned outage on the Halvard offshore pipeline cut supply for several hours in the morning. The operator said in the afternoon that the line was running again at reduced pressure. Traders also pointed to a smaller rise in fuel stocks than expected in the weekly figures.\n\nPrecious metals eased. Gold slipped 0.4 percent to 2,388.15 dollars an ounce and silver 1.1 percent to 28.35, as the dollar firmed ahead of Thursday's rate decision. Gold is still up by about a fifth this year, helped by buying from central banks.\n\nCopper gained 0.8 percent to 4.12 dollars a pound on hopes of stronger demand from construction, after two large building projects were approved this week. Stocks in the exchange's warehouses fell for the sixth day in a row.\n\nDecember wheat was unchanged at 5.64 dollars a bushel, with the harvest in the southern growing regions on schedule and export demand steady.\n\nPrices are the exchange's settlement prices for the front month, except wheat, which is the December contract. Changes are against Tuesday's settlement. Nothing in this clip is investment advice.",
"hashtags": [
"commodities",
"oil",
"Brent",
"gold",
"naturalgas",
"copper",
"silver",
"wheat",
"markets",
"trading",
"NorthwindExchange"
]
}
}
}
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.