Ranked bars, Broadcast news 1.0.0
| Template | Ranked bars, tpl_8c269cd3852b |
|---|---|
| Variant | Broadcast news |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 13 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 thirty things ranked by one value: bars, longest first, growing one after another with their values counting, up to ten to a page. 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 is ranked, the prefix and unit of every value, the items, a line of context, the source and the look. | |
clipData.kicker | text | up to 20 characters | Kicker: A word above the title, such as RANKING or THIS WEEK. | |
clipData.title | text | yes | up to 80 characters | Title: What is ranked and by what. |
clipData.prefix | text | up to 3 characters | Prefix: Written before every value, such as a currency sign. | |
clipData.unit | text | up to 8 characters | Unit: Written after every value: a percent sign, bn, t, km. | |
clipData.items | list | yes | at least 2, up to 30 | Bars: Sorted longest first whatever order they are sent in, up to ten to a page: past ten they turn a page, and every page keeps the first page's scale. Two to thirty; each adds under a second. |
clipData.items[] | group | Bar | ||
clipData.items[].label | text | yes | up to 26 characters | Label |
clipData.items[].value | number | yes | from 0, 4 decimals | Value |
clipData.items[].highlight | boolean | Mark this bar: Drawn in the accent colour, such as the one the story is about. Only the first marked bar is. | ||
clipData.note | text | up to 120 characters | Context: One or two lines under the bars. | |
clipData.source | text | up to 60 characters | Source | |
clipData.look | group | Look: How the clip looks and moves within its style. The same four 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. | |
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 RANKING or THIS WEEK."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What is ranked and by what."
},
"prefix": {
"type": "string",
"maxLength": 3,
"title": "Prefix",
"description": "Written before every value, such as a currency sign."
},
"unit": {
"type": "string",
"maxLength": 8,
"title": "Unit",
"description": "Written after every value: a percent sign, bn, t, km."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 26,
"title": "Label"
},
"value": {
"type": "number",
"minimum": 0,
"title": "Value"
},
"highlight": {
"type": "boolean",
"title": "Mark this bar",
"description": "Drawn in the accent colour, such as the one the story is about. Only the first marked bar is."
}
},
"required": [
"label",
"value"
],
"additionalProperties": false,
"title": "Bar"
},
"minItems": 2,
"maxItems": 30,
"title": "Bars",
"description": "Sorted longest first whatever order they are sent in, up to ten to a page: past ten they turn a page, and every page keeps the first page's scale. Two to thirty; each adds under a second."
},
"note": {
"type": "string",
"maxLength": 120,
"title": "Context",
"description": "One or two lines under the bars."
},
"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."
},
"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."
},
"corners": {
"type": "string",
"enum": [
"auto",
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, panels and marks."
},
"align": {
"type": "string",
"enum": [
"auto",
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up."
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves within its style. The same four 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 is ranked, the prefix and unit of every value, the items, 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 above the title, such as RANKING or THIS WEEK."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What is ranked and by what."
},
"prefix": {
"type": "string",
"maxLength": 3,
"title": "Prefix",
"description": "Written before every value, such as a currency sign."
},
"unit": {
"type": "string",
"maxLength": 8,
"title": "Unit",
"description": "Written after every value: a percent sign, bn, t, km."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 26,
"title": "Label"
},
"value": {
"type": "number",
"minimum": 0,
"title": "Value"
},
"highlight": {
"type": "boolean",
"title": "Mark this bar",
"description": "Drawn in the accent colour, such as the one the story is about. Only the first marked bar is."
}
},
"required": [
"label",
"value"
],
"additionalProperties": false,
"title": "Bar"
},
"minItems": 2,
"maxItems": 30,
"title": "Bars",
"description": "Sorted longest first whatever order they are sent in, up to ten to a page: past ten they turn a page, and every page keeps the first page's scale. Two to thirty; each adds under a second."
},
"note": {
"type": "string",
"maxLength": 120,
"title": "Context",
"description": "One or two lines under the bars."
},
"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."
},
"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."
},
"corners": {
"type": "string",
"enum": [
"auto",
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, panels and marks."
},
"align": {
"type": "string",
"enum": [
"auto",
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up."
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves within its style. The same four 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 is ranked, the prefix and unit of every value, the items, 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_8c269cd3852b?variant=Broadcast%20news&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": "Market value",
"title": "The ten largest companies on the Northwind exchange, by market value",
"prefix": "$",
"unit": "bn",
"items": [
{
"label": "Meridian Bank Group",
"value": 412.6
},
{
"label": "Halden Works",
"value": 298.4,
"highlight": true
},
{
"label": "Serrena Group",
"value": 288.1
},
{
"label": "Corvane Energy",
"value": 214.9
},
{
"label": "Talvik Telecom",
"value": 176.3
},
{
"label": "Northwind Rail & Freight",
"value": 149.8
},
{
"label": "Lunetta Pharma",
"value": 131.2
},
{
"label": "Brightwater Utilities",
"value": 97.5
},
{
"label": "Oskar Retail",
"value": 84
},
{
"label": "Fennick Logistics",
"value": 61.7
}
],
"note": "Halden Works passed Serrena Group for second place on Thursday after its order book doubled",
"source": "Northwind Exchange, closing prices on 30 September",
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto"
}
},
"metaData": {
"title": "Halden Works is now the second largest company on the Northwind exchange",
"captionTiny": "Halden Works passed Serrena Group to become the second largest company on the Northwind exchange, worth 298.4 billion dollars.",
"captionShort": "Halden Works passed Serrena Group on Thursday to become the second largest company on the Northwind exchange, worth 298.4 billion dollars at the close. Meridian Bank Group stays first at 412.6 billion. Here are the ten largest by market value.",
"captionMedium": "Halden Works passed Serrena Group on Thursday to become the second largest company on the Northwind exchange, worth 298.4 billion dollars at the close after its order book doubled. Meridian Bank Group stays first at 412.6 billion dollars, more than Corvane Energy and Talvik Telecom together. The ten largest companies are worth a combined 1.9 trillion dollars, about half of the whole exchange. Here they are, ranked by market value at Thursday's closing prices.",
"captionLong": "Halden Works passed Serrena Group on Thursday to become the second largest company on the Northwind exchange, worth 298.4 billion dollars at the close after its order book doubled. Meridian Bank Group stays first at 412.6 billion dollars, more than Corvane Energy and Talvik Telecom together. The ten largest companies are worth a combined 1.9 trillion dollars, about half of the whole exchange. Northwind Rail and Freight is the only newcomer this year, while Brightwater Utilities fell two places after a weak summer. Here they are, ranked by market value at Thursday's closing prices. Figures are illustrative.",
"hashtags": [
"markets",
"stocks",
"ranking"
]
}
}
}
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.