Agenda, Soft friendly 1.0.0
| Template | Agenda, tpl_185b86441795 |
|---|---|
| Variant | Soft friendly |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 14 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
A column of times with what happens at each, the item on now marked, up to sixteen in pages. 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 agenda is for, the items with their times, details and tags, which one is on now, the source and the look. | |
clipData.kicker | text | up to 20 characters | Kicker: A word above the title, such as TONIGHT or TODAY. | |
clipData.title | text | yes | up to 80 characters | Title: What the agenda is for. |
clipData.items | list | yes | at least 2, up to 16 | Items: In the order they happen, earliest first. Two to sixteen; past what one page holds they turn a page. Each adds just over a second. |
clipData.items[] | group | Item | ||
clipData.items[].time | text | yes | up to 13 characters | Time: When it starts, as it should be read: 19:30, 7.30 pm, 10:00 to 10:45. |
clipData.items[].title | text | yes | up to 50 characters | What |
clipData.items[].detail | text | up to 70 characters | Detail: One line under it: who, where or what it is about. | |
clipData.items[].tag | text | up to 16 characters | Tag: A word of category above it, such as News or Room 2. | |
clipData.current | integer | from 1, to 8 | On now: Which item is happening now, counted from 1 at the top. Left out, none is marked. | |
clipData.currentLabel | text | up to 16 characters | On now label: The words beside the item on now, such as On now or Next up. | |
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 TONIGHT or TODAY."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What the agenda is for."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"time": {
"type": "string",
"maxLength": 13,
"title": "Time",
"description": "When it starts, as it should be read: 19:30, 7.30 pm, 10:00 to 10:45."
},
"title": {
"type": "string",
"maxLength": 50,
"title": "What"
},
"detail": {
"type": "string",
"maxLength": 70,
"title": "Detail",
"description": "One line under it: who, where or what it is about."
},
"tag": {
"type": "string",
"maxLength": 16,
"title": "Tag",
"description": "A word of category above it, such as News or Room 2."
}
},
"required": [
"time",
"title"
],
"additionalProperties": false,
"title": "Item"
},
"minItems": 2,
"maxItems": 16,
"title": "Items",
"description": "In the order they happen, earliest first. Two to sixteen; past what one page holds they turn a page. Each adds just over a second."
},
"current": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"title": "On now",
"description": "Which item is happening now, counted from 1 at the top. Left out, none is marked."
},
"currentLabel": {
"type": "string",
"maxLength": 16,
"title": "On now label",
"description": "The words beside the item on now, such as On now or Next up."
},
"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 agenda is for, the items with their times, details and tags, which one is on now, 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 TONIGHT or TODAY."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What the agenda is for."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"time": {
"type": "string",
"maxLength": 13,
"title": "Time",
"description": "When it starts, as it should be read: 19:30, 7.30 pm, 10:00 to 10:45."
},
"title": {
"type": "string",
"maxLength": 50,
"title": "What"
},
"detail": {
"type": "string",
"maxLength": 70,
"title": "Detail",
"description": "One line under it: who, where or what it is about."
},
"tag": {
"type": "string",
"maxLength": 16,
"title": "Tag",
"description": "A word of category above it, such as News or Room 2."
}
},
"required": [
"time",
"title"
],
"additionalProperties": false,
"title": "Item"
},
"minItems": 2,
"maxItems": 16,
"title": "Items",
"description": "In the order they happen, earliest first. Two to sixteen; past what one page holds they turn a page. Each adds just over a second."
},
"current": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"title": "On now",
"description": "Which item is happening now, counted from 1 at the top. Left out, none is marked."
},
"currentLabel": {
"type": "string",
"maxLength": 16,
"title": "On now label",
"description": "The words beside the item on now, such as On now or Next up."
},
"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 agenda is for, the items with their times, details and tags, which one is on now, 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_185b86441795?variant=Soft%20friendly&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": "Tonight",
"title": "What is on Northwind Two tonight, from the early news to the late film",
"items": [
{
"tag": "News",
"time": "18:00",
"title": "Evening News",
"detail": "Headlines from home and abroad, with the weather at 18:25"
},
{
"tag": "Documentary",
"time": "18:30",
"title": "Harbour Lives",
"detail": "The pilots who bring the big ships in through the winter storms"
},
{
"tag": "Cooking",
"time": "19:15",
"title": "The Kitchen Table",
"detail": "Three dinners from one market basket, cooked in under an hour"
},
{
"tag": "Entertainment",
"time": "20:00",
"title": "Quiz Night at the Lantern",
"detail": "Four teams from four towns, one trophy and a lot of questions"
},
{
"tag": "Drama",
"time": "21:00",
"title": "Coldwater, episode 4: the night the ferry stopped",
"detail": "Inspector Hale finds the missing ledger, and somebody wants it back"
},
{
"tag": "News",
"time": "22:00",
"title": "Late News and Weather",
"detail": "The day's main stories and the forecast for the morning"
},
{
"tag": "Film",
"time": "22:30",
"title": "Film: The Quiet Lighthouse",
"detail": "A keeper and a stranded sailor wait out a storm on a rock at sea"
},
{
"tag": "Music",
"time": "00:20",
"title": "Night Music",
"detail": "Recorded live at the Arden Hall, autumn season"
}
],
"current": 4,
"currentLabel": "On now",
"source": "Northwind Two schedule, times in local time",
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto",
"logo": "auto"
}
},
"metaData": {
"title": "Tonight on Northwind Two: news, a harbour documentary, quiz night and the late film",
"captionTiny": "Tonight on Northwind Two: Quiz Night at the Lantern is on now, then Coldwater at 21:00 and the late film at 22:30.",
"captionShort": "Tonight on Northwind Two: Quiz Night at the Lantern is on now, with four teams from four towns. Coldwater continues at 21:00, the late news is at 22:00 and The Quiet Lighthouse closes the evening at 22:30.",
"captionMedium": "Tonight on Northwind Two: Quiz Night at the Lantern is on now, with four teams from four towns playing for one trophy. Earlier came the Evening News, Harbour Lives with the pilots who bring the big ships in, and The Kitchen Table. Coldwater continues at 21:00 with episode 4, the night the ferry stopped. The late news and weather are at 22:00, and the film The Quiet Lighthouse closes the evening at 22:30, followed by Night Music from the Arden Hall.",
"captionLong": "Tonight on Northwind Two: Quiz Night at the Lantern is on now, with four teams from four towns playing for one trophy. Earlier in the evening came the Evening News at 18:00, Harbour Lives at 18:30 with the pilots who bring the big ships in through the winter storms, and The Kitchen Table at 19:15 with three dinners from one market basket. Coldwater continues at 21:00 with episode 4, the night the ferry stopped, as Inspector Hale finds the missing ledger. The late news and the weather for the morning are at 22:00. The film The Quiet Lighthouse, about a keeper and a stranded sailor waiting out a storm, closes the evening at 22:30, followed by Night Music recorded live at the Arden Hall. All times are local time.",
"hashtags": [
"tonight",
"tvguide",
"northwindtwo"
]
}
}
}
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.