Bubble cluster, Broadcast news 1.0.0
| Template | Bubble cluster, tpl_b3103d4f8521 |
|---|---|
| Variant | Broadcast news |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 11 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
Three to sixteen subjects as circles whose area is their value, rolling in largest first and settling into one cluster in the middle of the frame, each named and valued inside its circle or beside it on a leader line. 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 subjects with their values (and a change where the circles are coloured by it), 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 IN NUMBERS or CONTROL ROOM. | |
clipData.title | text | yes | up to 80 characters | Title |
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: calls, bn, %, people. | |
clipData.colours | enum | subjects, change, one | Colours: Several colours: the circles in colours built from your brand colour, no two that touch alike. By the change: each circle in your brand's up or down colour, as strong as its change, with a key. One colour: every circle in your brand colour. | |
clipData.changeLabel | text | up to 30 characters | What the colour shows: Written over the colour key when the circles are coloured by their change. | |
clipData.changeUnit | text | up to 6 characters | Unit of the change: Written after the change on the colour key. Left out, a percent sign. | |
clipData.items | list | yes | at least 3, up to 16 | Subjects: Three to sixteen subjects, each a circle whose area is its value. They roll in largest first, whatever order they are sent in, and are named inside their circle where the name fits and beside it where it does not. |
clipData.items[] | group | Subject | ||
clipData.items[].label | text | yes | up to 32 characters | Name |
clipData.items[].value | number | yes | from 0, 4 decimals | Value: The circle's area: twice the value, twice the area. Above nought. |
clipData.items[].change | number | 2 decimals | Change: Read only when the circles are coloured by their change: how much the subject rose or fell, in the change's unit. | |
clipData.note | text | up to 140 characters | Context: One or two lines of context beside or under the cluster. | |
clipData.source | text | up to 60 characters | Source: Where the figures come from: an official or open source by name, anything else by what the figures are. | |
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 400
schema_validation error 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 IN NUMBERS or CONTROL ROOM."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title"
},
"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: calls, bn, %, people."
},
"colours": {
"type": "string",
"enum": [
"subjects",
"change",
"one"
],
"title": "Colours",
"description": "Several colours: the circles in colours built from your brand colour, no two that touch alike. By the change: each circle in your brand's up or down colour, as strong as its change, with a key. One colour: every circle in your brand colour.",
"enumNames": [
"Several colours, from the brand",
"By the change, in the brand's up and down colours",
"One colour, the brand's"
]
},
"changeLabel": {
"type": "string",
"maxLength": 30,
"title": "What the colour shows",
"description": "Written over the colour key when the circles are coloured by their change."
},
"changeUnit": {
"type": "string",
"maxLength": 6,
"title": "Unit of the change",
"description": "Written after the change on the colour key. Left out, a percent sign."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 32,
"title": "Name"
},
"value": {
"type": "number",
"minimum": 0,
"title": "Value",
"description": "The circle's area: twice the value, twice the area. Above nought."
},
"change": {
"type": "number",
"title": "Change",
"description": "Read only when the circles are coloured by their change: how much the subject rose or fell, in the change's unit."
}
},
"required": [
"label",
"value"
],
"additionalProperties": false,
"title": "Subject"
},
"minItems": 3,
"maxItems": 16,
"title": "Subjects",
"description": "Three to sixteen subjects, each a circle whose area is its value. They roll in largest first, whatever order they are sent in, and are named inside their circle where the name fits and beside it where it does not."
},
"note": {
"type": "string",
"maxLength": 140,
"title": "Context",
"description": "One or two lines of context beside or under the cluster."
},
"source": {
"type": "string",
"maxLength": 60,
"title": "Source",
"description": "Where the figures come from: an official or open source by name, anything else by what the figures are."
},
"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, the title, the subjects with their values (and a change where the circles are coloured by it), 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 IN NUMBERS or CONTROL ROOM."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title"
},
"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: calls, bn, %, people."
},
"colours": {
"type": "string",
"enum": [
"subjects",
"change",
"one"
],
"title": "Colours",
"description": "Several colours: the circles in colours built from your brand colour, no two that touch alike. By the change: each circle in your brand's up or down colour, as strong as its change, with a key. One colour: every circle in your brand colour.",
"enumNames": [
"Several colours, from the brand",
"By the change, in the brand's up and down colours",
"One colour, the brand's"
]
},
"changeLabel": {
"type": "string",
"maxLength": 30,
"title": "What the colour shows",
"description": "Written over the colour key when the circles are coloured by their change."
},
"changeUnit": {
"type": "string",
"maxLength": 6,
"title": "Unit of the change",
"description": "Written after the change on the colour key. Left out, a percent sign."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 32,
"title": "Name"
},
"value": {
"type": "number",
"minimum": 0,
"title": "Value",
"description": "The circle's area: twice the value, twice the area. Above nought."
},
"change": {
"type": "number",
"title": "Change",
"description": "Read only when the circles are coloured by their change: how much the subject rose or fell, in the change's unit."
}
},
"required": [
"label",
"value"
],
"additionalProperties": false,
"title": "Subject"
},
"minItems": 3,
"maxItems": 16,
"title": "Subjects",
"description": "Three to sixteen subjects, each a circle whose area is its value. They roll in largest first, whatever order they are sent in, and are named inside their circle where the name fits and beside it where it does not."
},
"note": {
"type": "string",
"maxLength": 140,
"title": "Context",
"description": "One or two lines of context beside or under the cluster."
},
"source": {
"type": "string",
"maxLength": 60,
"title": "Source",
"description": "Where the figures come from: an official or open source by name, anything else by what the figures are."
},
"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 subjects with their values (and a change where the circles are coloured by it), 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_b3103d4f8521?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": "Control room",
"title": "What Kestrel Bay's emergency line was called about in September",
"prefix": "",
"unit": "calls",
"colours": "subjects",
"changeLabel": "Change on August",
"changeUnit": "%",
"items": [
{
"label": "Medical emergencies",
"value": 1840,
"change": 4.2
},
{
"label": "Traffic accidents",
"value": 912,
"change": -6.1
},
{
"label": "Falls and injuries at home",
"value": 744,
"change": 11.8
},
{
"label": "Noise complaints",
"value": 520,
"change": -14.5
},
{
"label": "Fires and smoke",
"value": 318,
"change": 2.3
},
{
"label": "Burglary reports",
"value": 266,
"change": -9.4
},
{
"label": "Other calls",
"value": 207,
"change": 0.8
},
{
"label": "Flooded cellars",
"value": 190,
"change": 63
},
{
"label": "Animals in trouble",
"value": 142,
"change": -3.4
},
{
"label": "Smell of gas",
"value": 96,
"change": 7.9
},
{
"label": "Locked out of home",
"value": 81,
"change": -1.2
},
{
"label": "Lost property",
"value": 54,
"change": -22.9
}
],
"note": "5,370 calls in all, the most since the storm month of February. Flooded cellars rose after the heavy rain of the 14th",
"source": "Kestrel Bay fire and rescue service, monthly report",
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto",
"logo": "auto"
}
},
"metaData": {
"title": "Kestrel Bay's emergency calls in September: medical emergencies first, flooded cellars up",
"captionTiny": "Kestrel Bay's emergency line took 5,370 calls in September. Medical emergencies came first, and flooded cellars rose after the rain of the 14th.",
"captionShort": "Kestrel Bay's emergency line took 5,370 calls in September, the most since February. Medical emergencies came first with 1,840 calls, then traffic accidents and falls at home. Flooded cellars rose sharply after the heavy rain of the 14th. Call 112 only in an emergency; for everything else, the city's service line is open around the clock.",
"captionMedium": "Kestrel Bay's emergency line took 5,370 calls in September, the most since the storm month of February. Medical emergencies came first with 1,840 calls, followed by 912 traffic accidents and 744 falls and injuries at home. Noise complaints fell for the second month in a row. Flooded cellars rose sharply after the heavy rain of the 14th, to 190 calls in a single month. The fire and rescue service reminds everyone that 112 is for emergencies only: for a locked door, a lost wallet or a noisy neighbour, the city's service line is open around the clock and keeps the emergency line free for the calls that cannot wait.",
"captionLong": "Kestrel Bay's emergency line took 5,370 calls in September, the most since the storm month of February. Medical emergencies came first with 1,840 calls, followed by 912 traffic accidents and 744 falls and injuries at home, many of them older residents living alone. Noise complaints fell for the second month in a row, and burglary reports were down by almost a tenth. Flooded cellars rose sharply after the heavy rain of the 14th, to 190 calls in a single month, most of them in the lower town and along the harbour. The fire and rescue service reminds everyone that 112 is for emergencies only: for a locked door, a lost wallet or a noisy neighbour, the city's service line is open around the clock and keeps the emergency line free for the calls that cannot wait. The full monthly report, with every district, is published on the city's open data portal.",
"hashtags": [
"kestrelbay",
"112",
"emergency",
"citydata"
]
}
}
}
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.