Public bodies, Service change 1.0.0
| Template | Public bodies, tpl_4f9a6b9f3068 |
|---|---|
| Variant | Service change |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 18 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 change of opening hours, routes or services: one to seven rows of what it was and what it will be, from when, why, and where to get help. The clip is as long as the rows need. 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 in the clip: what changes, from when, the rows before and after, why, and where to get help. | |
clipData.kicker | text | up to 32 characters | Kicker: A short line above the headline, such as Service change or New timetable. | |
clipData.headline | text | yes | up to 70 characters | Headline: What changes, in one sentence. |
clipData.date | text | up to 48 characters | From: From when the change applies, as it should be read. | |
clipData.beforeLabel | text | up to 20 characters | Heading of the old values: Over the column of what it was, such as Until now or Old times. | |
clipData.afterLabel | text | up to 20 characters | Heading of the new values: Over the column of what it will be, such as From 3 November or New times. | |
clipData.rows | list | yes | at least 1, up to 7 | What changes: One to seven rows, each a label with what it was and what it will be: a day and its hours, a line and its route, a service and its place. A row without an old value is new; a row whose old and new values are the same is shown as unchanged. The clip gets about two seconds longer per row. |
clipData.rows[] | group | Row | ||
clipData.rows[].label | text | yes | up to 28 characters | Label: What the row is about, such as Monday, Line 4 or Passport photos. |
clipData.rows[].before | text | up to 28 characters | Until now: What it was. Leave it out for something new. | |
clipData.rows[].after | text | yes | up to 28 characters | From now on: What it will be, such as 8:00 to 18:00 or Closed. |
clipData.rows[].icon | enum | check, circle-check, x, arrow-right, arrow-up-right, plus, star, heart, thumbs-up, sparkles, zap, clock, calendar, map-pin, info, triangle-alert, lightbulb, target, award, crown, gem, flame, timer, list-checks, clipboard-check, badge-check, hand-heart, rocket, trophy, megaphone, bell, qr-code, ticket, gift, key-round, book-open, graduation-cap, house, phone, mail, globe, users, user, building, bus, train-front, bike, car, leaf, recycle, trees, file-text, thermometer, droplets, sun, cloud-rain, snowflake, wind, stethoscope, school, trash, accessibility, hand-helping | Icon: A symbol for the row, such as a bus for a line. None for a plain row. | |
clipData.reason | text | up to 160 characters | Why: Why it changes, in a sentence or two. | |
clipData.help | group | Where to get help: Where people turn with questions: a help line, a desk, a web page. | ||
clipData.help.label | text | up to 40 characters | What it is: What the help is, such as Citizen service desk or Travel line. | |
clipData.help.detail | text | up to 40 characters | Number or address: The number to call or the address to go to, drawn large. | |
clipData.help.note | text | up to 64 characters | Line under it: When it is open, a web address, anything else to know. | |
clipData.help.icon | enum | check, circle-check, x, arrow-right, arrow-up-right, plus, star, heart, thumbs-up, sparkles, zap, clock, calendar, map-pin, info, triangle-alert, lightbulb, target, award, crown, gem, flame, timer, list-checks, clipboard-check, badge-check, hand-heart, rocket, trophy, megaphone, bell, qr-code, ticket, gift, key-round, book-open, graduation-cap, house, phone, mail, globe, users, user, building, bus, train-front, bike, car, leaf, recycle, trees, file-text, thermometer, droplets, sun, cloud-rain, snowflake, wind, stethoscope, school, trash, accessibility, hand-helping | Icon: The symbol on the card. A phone where none is chosen. | |
clipData.disclaimer | text | up to 120 characters | Small print: Anything that must be said with the change, shown at the foot. | |
clipData.look | group | Look: How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default. | ||
clipData.look.theme | enum | brand, light, dark, bold | Theme: Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page. | |
clipData.look.pace | enum | calm, standard, punchy | Pace: How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts. | |
clipData.look.corners | enum | square, soft, round | Corners: The shape of cards, pictures and buttons. | |
clipData.look.align | enum | start, centre | Text alignment: Where the text lines up. | |
clipData.look.layout | enum | table, cards | Layout: Table: the rows build up one by one into a before and after table. Cards: one row at a time, large, the old value struck through and the new one arriving. | |
clipData.look.strike | boolean | Strike through the old values: A line drawn through each old value that changes, as you watch. | ||
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": 32,
"title": "Kicker",
"description": "A short line above the headline, such as Service change or New timetable."
},
"headline": {
"type": "string",
"maxLength": 70,
"title": "Headline",
"description": "What changes, in one sentence."
},
"date": {
"type": "string",
"maxLength": 48,
"title": "From",
"description": "From when the change applies, as it should be read."
},
"beforeLabel": {
"type": "string",
"maxLength": 20,
"title": "Heading of the old values",
"description": "Over the column of what it was, such as Until now or Old times."
},
"afterLabel": {
"type": "string",
"maxLength": 20,
"title": "Heading of the new values",
"description": "Over the column of what it will be, such as From 3 November or New times."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Label",
"description": "What the row is about, such as Monday, Line 4 or Passport photos."
},
"before": {
"type": "string",
"maxLength": 28,
"title": "Until now",
"description": "What it was. Leave it out for something new."
},
"after": {
"type": "string",
"maxLength": 28,
"title": "From now on",
"description": "What it will be, such as 8:00 to 18:00 or Closed."
},
"icon": {
"type": "string",
"enum": [
"check",
"circle-check",
"x",
"arrow-right",
"arrow-up-right",
"plus",
"star",
"heart",
"thumbs-up",
"sparkles",
"zap",
"clock",
"calendar",
"map-pin",
"info",
"triangle-alert",
"lightbulb",
"target",
"award",
"crown",
"gem",
"flame",
"timer",
"list-checks",
"clipboard-check",
"badge-check",
"hand-heart",
"rocket",
"trophy",
"megaphone",
"bell",
"qr-code",
"ticket",
"gift",
"key-round",
"book-open",
"graduation-cap",
"house",
"phone",
"mail",
"globe",
"users",
"user",
"building",
"bus",
"train-front",
"bike",
"car",
"leaf",
"recycle",
"trees",
"file-text",
"thermometer",
"droplets",
"sun",
"cloud-rain",
"snowflake",
"wind",
"stethoscope",
"school",
"trash",
"accessibility",
"hand-helping"
],
"title": "Icon",
"description": "A symbol for the row, such as a bus for a line. None for a plain row.",
"enumNames": [
"Check",
"Circle check",
"X",
"Arrow right",
"Arrow up right",
"Plus",
"Star",
"Heart",
"Thumbs up",
"Sparkles",
"Zap",
"Clock",
"Calendar",
"Map pin",
"Info",
"Triangle alert",
"Lightbulb",
"Target",
"Award",
"Crown",
"Gem",
"Flame",
"Timer",
"List checks",
"Clipboard check",
"Badge check",
"Hand heart",
"Rocket",
"Trophy",
"Megaphone",
"Bell",
"Qr code",
"Ticket",
"Gift",
"Key round",
"Book open",
"Graduation cap",
"House",
"Phone",
"Mail",
"Globe",
"Users",
"User",
"Building",
"Bus",
"Train front",
"Bike",
"Car",
"Leaf",
"Recycle",
"Trees",
"File text",
"Thermometer",
"Droplets",
"Sun",
"Cloud rain",
"Snowflake",
"Wind",
"Stethoscope",
"School",
"Trash",
"Accessibility",
"Hand helping"
]
}
},
"required": [
"label",
"after"
],
"additionalProperties": false,
"title": "Row"
},
"minItems": 1,
"maxItems": 7,
"title": "What changes",
"description": "One to seven rows, each a label with what it was and what it will be: a day and its hours, a line and its route, a service and its place. A row without an old value is new; a row whose old and new values are the same is shown as unchanged. The clip gets about two seconds longer per row."
},
"reason": {
"type": "string",
"maxLength": 160,
"title": "Why",
"description": "Why it changes, in a sentence or two."
},
"help": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 40,
"title": "What it is",
"description": "What the help is, such as Citizen service desk or Travel line."
},
"detail": {
"type": "string",
"maxLength": 40,
"title": "Number or address",
"description": "The number to call or the address to go to, drawn large."
},
"note": {
"type": "string",
"maxLength": 64,
"title": "Line under it",
"description": "When it is open, a web address, anything else to know."
},
"icon": {
"type": "string",
"enum": [
"check",
"circle-check",
"x",
"arrow-right",
"arrow-up-right",
"plus",
"star",
"heart",
"thumbs-up",
"sparkles",
"zap",
"clock",
"calendar",
"map-pin",
"info",
"triangle-alert",
"lightbulb",
"target",
"award",
"crown",
"gem",
"flame",
"timer",
"list-checks",
"clipboard-check",
"badge-check",
"hand-heart",
"rocket",
"trophy",
"megaphone",
"bell",
"qr-code",
"ticket",
"gift",
"key-round",
"book-open",
"graduation-cap",
"house",
"phone",
"mail",
"globe",
"users",
"user",
"building",
"bus",
"train-front",
"bike",
"car",
"leaf",
"recycle",
"trees",
"file-text",
"thermometer",
"droplets",
"sun",
"cloud-rain",
"snowflake",
"wind",
"stethoscope",
"school",
"trash",
"accessibility",
"hand-helping"
],
"title": "Icon",
"description": "The symbol on the card. A phone where none is chosen.",
"enumNames": [
"Check",
"Circle check",
"X",
"Arrow right",
"Arrow up right",
"Plus",
"Star",
"Heart",
"Thumbs up",
"Sparkles",
"Zap",
"Clock",
"Calendar",
"Map pin",
"Info",
"Triangle alert",
"Lightbulb",
"Target",
"Award",
"Crown",
"Gem",
"Flame",
"Timer",
"List checks",
"Clipboard check",
"Badge check",
"Hand heart",
"Rocket",
"Trophy",
"Megaphone",
"Bell",
"Qr code",
"Ticket",
"Gift",
"Key round",
"Book open",
"Graduation cap",
"House",
"Phone",
"Mail",
"Globe",
"Users",
"User",
"Building",
"Bus",
"Train front",
"Bike",
"Car",
"Leaf",
"Recycle",
"Trees",
"File text",
"Thermometer",
"Droplets",
"Sun",
"Cloud rain",
"Snowflake",
"Wind",
"Stethoscope",
"School",
"Trash",
"Accessibility",
"Hand helping"
]
}
},
"additionalProperties": false,
"title": "Where to get help",
"description": "Where people turn with questions: a help line, a desk, a web page."
},
"disclaimer": {
"type": "string",
"maxLength": 120,
"title": "Small print",
"description": "Anything that must be said with the change, shown at the foot."
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page.",
"enumNames": [
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts.",
"enumNames": [
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, pictures and buttons.",
"enumNames": [
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"At the start of the line",
"Centred"
]
},
"layout": {
"type": "string",
"enum": [
"table",
"cards"
],
"title": "Layout",
"description": "Table: the rows build up one by one into a before and after table. Cards: one row at a time, large, the old value struck through and the new one arriving.",
"enumNames": [
"A table building up",
"One row at a time"
]
},
"strike": {
"type": "boolean",
"title": "Strike through the old values",
"description": "A line drawn through each old value that changes, as you watch."
},
"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. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default."
}
},
"required": [
"headline",
"rows"
],
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn in the clip: what changes, from when, the rows before and after, why, and where to get help."
},
"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": 32,
"title": "Kicker",
"description": "A short line above the headline, such as Service change or New timetable."
},
"headline": {
"type": "string",
"maxLength": 70,
"title": "Headline",
"description": "What changes, in one sentence."
},
"date": {
"type": "string",
"maxLength": 48,
"title": "From",
"description": "From when the change applies, as it should be read."
},
"beforeLabel": {
"type": "string",
"maxLength": 20,
"title": "Heading of the old values",
"description": "Over the column of what it was, such as Until now or Old times."
},
"afterLabel": {
"type": "string",
"maxLength": 20,
"title": "Heading of the new values",
"description": "Over the column of what it will be, such as From 3 November or New times."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Label",
"description": "What the row is about, such as Monday, Line 4 or Passport photos."
},
"before": {
"type": "string",
"maxLength": 28,
"title": "Until now",
"description": "What it was. Leave it out for something new."
},
"after": {
"type": "string",
"maxLength": 28,
"title": "From now on",
"description": "What it will be, such as 8:00 to 18:00 or Closed."
},
"icon": {
"type": "string",
"enum": [
"check",
"circle-check",
"x",
"arrow-right",
"arrow-up-right",
"plus",
"star",
"heart",
"thumbs-up",
"sparkles",
"zap",
"clock",
"calendar",
"map-pin",
"info",
"triangle-alert",
"lightbulb",
"target",
"award",
"crown",
"gem",
"flame",
"timer",
"list-checks",
"clipboard-check",
"badge-check",
"hand-heart",
"rocket",
"trophy",
"megaphone",
"bell",
"qr-code",
"ticket",
"gift",
"key-round",
"book-open",
"graduation-cap",
"house",
"phone",
"mail",
"globe",
"users",
"user",
"building",
"bus",
"train-front",
"bike",
"car",
"leaf",
"recycle",
"trees",
"file-text",
"thermometer",
"droplets",
"sun",
"cloud-rain",
"snowflake",
"wind",
"stethoscope",
"school",
"trash",
"accessibility",
"hand-helping"
],
"title": "Icon",
"description": "A symbol for the row, such as a bus for a line. None for a plain row.",
"enumNames": [
"Check",
"Circle check",
"X",
"Arrow right",
"Arrow up right",
"Plus",
"Star",
"Heart",
"Thumbs up",
"Sparkles",
"Zap",
"Clock",
"Calendar",
"Map pin",
"Info",
"Triangle alert",
"Lightbulb",
"Target",
"Award",
"Crown",
"Gem",
"Flame",
"Timer",
"List checks",
"Clipboard check",
"Badge check",
"Hand heart",
"Rocket",
"Trophy",
"Megaphone",
"Bell",
"Qr code",
"Ticket",
"Gift",
"Key round",
"Book open",
"Graduation cap",
"House",
"Phone",
"Mail",
"Globe",
"Users",
"User",
"Building",
"Bus",
"Train front",
"Bike",
"Car",
"Leaf",
"Recycle",
"Trees",
"File text",
"Thermometer",
"Droplets",
"Sun",
"Cloud rain",
"Snowflake",
"Wind",
"Stethoscope",
"School",
"Trash",
"Accessibility",
"Hand helping"
]
}
},
"required": [
"label",
"after"
],
"additionalProperties": false,
"title": "Row"
},
"minItems": 1,
"maxItems": 7,
"title": "What changes",
"description": "One to seven rows, each a label with what it was and what it will be: a day and its hours, a line and its route, a service and its place. A row without an old value is new; a row whose old and new values are the same is shown as unchanged. The clip gets about two seconds longer per row."
},
"reason": {
"type": "string",
"maxLength": 160,
"title": "Why",
"description": "Why it changes, in a sentence or two."
},
"help": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 40,
"title": "What it is",
"description": "What the help is, such as Citizen service desk or Travel line."
},
"detail": {
"type": "string",
"maxLength": 40,
"title": "Number or address",
"description": "The number to call or the address to go to, drawn large."
},
"note": {
"type": "string",
"maxLength": 64,
"title": "Line under it",
"description": "When it is open, a web address, anything else to know."
},
"icon": {
"type": "string",
"enum": [
"check",
"circle-check",
"x",
"arrow-right",
"arrow-up-right",
"plus",
"star",
"heart",
"thumbs-up",
"sparkles",
"zap",
"clock",
"calendar",
"map-pin",
"info",
"triangle-alert",
"lightbulb",
"target",
"award",
"crown",
"gem",
"flame",
"timer",
"list-checks",
"clipboard-check",
"badge-check",
"hand-heart",
"rocket",
"trophy",
"megaphone",
"bell",
"qr-code",
"ticket",
"gift",
"key-round",
"book-open",
"graduation-cap",
"house",
"phone",
"mail",
"globe",
"users",
"user",
"building",
"bus",
"train-front",
"bike",
"car",
"leaf",
"recycle",
"trees",
"file-text",
"thermometer",
"droplets",
"sun",
"cloud-rain",
"snowflake",
"wind",
"stethoscope",
"school",
"trash",
"accessibility",
"hand-helping"
],
"title": "Icon",
"description": "The symbol on the card. A phone where none is chosen.",
"enumNames": [
"Check",
"Circle check",
"X",
"Arrow right",
"Arrow up right",
"Plus",
"Star",
"Heart",
"Thumbs up",
"Sparkles",
"Zap",
"Clock",
"Calendar",
"Map pin",
"Info",
"Triangle alert",
"Lightbulb",
"Target",
"Award",
"Crown",
"Gem",
"Flame",
"Timer",
"List checks",
"Clipboard check",
"Badge check",
"Hand heart",
"Rocket",
"Trophy",
"Megaphone",
"Bell",
"Qr code",
"Ticket",
"Gift",
"Key round",
"Book open",
"Graduation cap",
"House",
"Phone",
"Mail",
"Globe",
"Users",
"User",
"Building",
"Bus",
"Train front",
"Bike",
"Car",
"Leaf",
"Recycle",
"Trees",
"File text",
"Thermometer",
"Droplets",
"Sun",
"Cloud rain",
"Snowflake",
"Wind",
"Stethoscope",
"School",
"Trash",
"Accessibility",
"Hand helping"
]
}
},
"additionalProperties": false,
"title": "Where to get help",
"description": "Where people turn with questions: a help line, a desk, a web page."
},
"disclaimer": {
"type": "string",
"maxLength": 120,
"title": "Small print",
"description": "Anything that must be said with the change, shown at the foot."
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page.",
"enumNames": [
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts.",
"enumNames": [
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, pictures and buttons.",
"enumNames": [
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"At the start of the line",
"Centred"
]
},
"layout": {
"type": "string",
"enum": [
"table",
"cards"
],
"title": "Layout",
"description": "Table: the rows build up one by one into a before and after table. Cards: one row at a time, large, the old value struck through and the new one arriving.",
"enumNames": [
"A table building up",
"One row at a time"
]
},
"strike": {
"type": "boolean",
"title": "Strike through the old values",
"description": "A line drawn through each old value that changes, as you watch."
},
"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. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default."
}
},
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn in the clip: what changes, from when, the rows before and after, why, and where to get help."
},
"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_4f9a6b9f3068?variant=Service%20change&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": "Service change",
"headline": "Longer opening hours at the Town Hall service centre",
"date": "From Monday 3 November",
"beforeLabel": "Until now",
"afterLabel": "From 3 November",
"rows": [
{
"after": "8:00 to 18:00",
"label": "Monday",
"before": "8:00 to 16:00"
},
{
"after": "8:00 to 18:00",
"label": "Tuesday",
"before": "8:00 to 16:00"
},
{
"after": "8:00 to 18:00",
"label": "Wednesday",
"before": "8:00 to 12:00"
},
{
"after": "8:00 to 19:30",
"label": "Thursday",
"before": "8:00 to 18:00"
},
{
"after": "8:00 to 12:00",
"label": "Friday",
"before": "8:00 to 12:00"
},
{
"after": "9:00 to 12:00",
"label": "Saturday",
"before": "Closed"
}
],
"reason": "We are opening for longer on weekdays and on Saturday mornings, so that more of you can come by after work.",
"help": {
"label": "Citizen service desk",
"detail": "0800 555 0100",
"note": "Book a time at westbrook.example/book",
"icon": "phone"
},
"disclaimer": "Closed on public holidays. Last ticket 15 minutes before closing.",
"look": {
"theme": "brand",
"pace": "standard",
"corners": "soft",
"align": "start",
"layout": "table",
"strike": true,
"logo": "auto"
}
},
"metaData": {
"title": "New opening hours at the Town Hall service centre",
"captionTiny": "From Monday 3 November the Town Hall service centre opens longer on weekdays and on Saturday mornings.",
"captionShort": "Longer opening hours at the Town Hall service centre from Monday 3 November: 8:00 to 18:00 Monday to Wednesday, until 19:30 on Thursday and newly 9:00 to 12:00 on Saturday. Questions: 0800 555 0100.",
"captionMedium": "From Monday 3 November the Town Hall service centre opens for longer. Monday to Wednesday we are open from 8:00 to 18:00, on Thursday until 19:30, on Friday as before from 8:00 to 12:00, and on Saturday mornings from 9:00 to 12:00 for the first time. We are opening for longer so that more of you can come by after work. Book a time at westbrook.example/book or call the citizen service desk on 0800 555 0100. Closed on public holidays.",
"captionLong": "From Monday 3 November the Town Hall service centre opens for longer. Monday to Wednesday we are open from 8:00 to 18:00 instead of closing at 16:00 or at noon, on Thursday until 19:30, on Friday as before from 8:00 to 12:00, and on Saturday mornings from 9:00 to 12:00 for the first time. We are opening for longer so that more of you can come by after work, without taking time off. Passports, identity cards, registrations and parking permits are all handled at the same desks. Book a time at westbrook.example/book to skip the queue, or call the citizen service desk on 0800 555 0100. Closed on public holidays; the last ticket is given out 15 minutes before closing.",
"hashtags": [
"westbrook",
"openinghours",
"townhall",
"citizenservices"
]
}
}
}
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.