Countdown, Swiss grid 1.0.0
| Template | Countdown, tpl_7d1299a9e0ba |
|---|---|
| Variant | Swiss grid |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 16 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
The time left until a date, or gone since one, in days, hours and minutes, worked out from the sent moment and never from the clock, the digits rolling into place, and up to five more dates after it, one at a time. 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 counted, the date and the moment counted from, how precisely, the date in words, a line of context, up to five more dates each on a page of its own, the source and the look. | |
clipData.kicker | text | up to 20 characters | Kicker: A word above the title, such as COUNTDOWN or SAVE THE DATE. | |
clipData.title | text | yes | up to 80 characters | Title: What is counted down to, or up from. |
clipData.target | datetime | yes | Date: The moment counted down to, or up from. | |
clipData.asOf | datetime | yes | As of: The moment the time is counted from, usually when the post goes out. Never the clock: the clip shows the time left as of this moment. | |
clipData.direction | enum | until, since | Direction: Time left until the date, or time gone since it. | |
clipData.precision | enum | days, hours, minutes | Smallest unit: The smallest unit shown. Days alone suit anything weeks or more away. | |
clipData.dateText | text | up to 60 characters | Date in words: How the date is written under the countdown. Left out, it is written from the date. | |
clipData.note | text | up to 140 characters | Context: One or two lines under the date. | |
clipData.more | list | at least 0, up to 5 | More dates: Further dates shown after the first, one at a time, each counted from the same moment and to the same precision. Each adds four seconds; five make a calendar of about 28 seconds. | |
clipData.more[] | group | Date | ||
clipData.more[].title | text | yes | up to 80 characters | What is counted |
clipData.more[].target | datetime | yes | The date | |
clipData.more[].direction | enum | until, since | Direction: Time left until the date, or time gone since it. | |
clipData.more[].dateText | text | up to 60 characters | The date in words: Left out, it is written from the date. | |
clipData.more[].note | text | up to 140 characters | Context | |
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 COUNTDOWN or SAVE THE DATE."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What is counted down to, or up from."
},
"target": {
"type": "string",
"format": "date-time",
"title": "Date",
"description": "The moment counted down to, or up from."
},
"asOf": {
"type": "string",
"format": "date-time",
"title": "As of",
"description": "The moment the time is counted from, usually when the post goes out. Never the clock: the clip shows the time left as of this moment."
},
"direction": {
"type": "string",
"enum": [
"until",
"since"
],
"title": "Direction",
"description": "Time left until the date, or time gone since it."
},
"precision": {
"type": "string",
"enum": [
"days",
"hours",
"minutes"
],
"title": "Smallest unit",
"description": "The smallest unit shown. Days alone suit anything weeks or more away."
},
"dateText": {
"type": "string",
"maxLength": 60,
"title": "Date in words",
"description": "How the date is written under the countdown. Left out, it is written from the date."
},
"note": {
"type": "string",
"maxLength": 140,
"title": "Context",
"description": "One or two lines under the date."
},
"more": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 80,
"title": "What is counted"
},
"target": {
"type": "string",
"format": "date-time",
"title": "The date"
},
"direction": {
"type": "string",
"enum": [
"until",
"since"
],
"title": "Direction",
"description": "Time left until the date, or time gone since it."
},
"dateText": {
"type": "string",
"maxLength": 60,
"title": "The date in words",
"description": "Left out, it is written from the date."
},
"note": {
"type": "string",
"maxLength": 140,
"title": "Context"
}
},
"required": [
"title",
"target"
],
"additionalProperties": false,
"title": "Date"
},
"minItems": 0,
"maxItems": 5,
"title": "More dates",
"description": "Further dates shown after the first, one at a time, each counted from the same moment and to the same precision. Each adds four seconds; five make a calendar of about 28 seconds."
},
"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",
"target",
"asOf"
],
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn: a kicker, what is counted, the date and the moment counted from, how precisely, the date in words, a line of context, up to five more dates each on a page of its own, 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 COUNTDOWN or SAVE THE DATE."
},
"title": {
"type": "string",
"maxLength": 80,
"title": "Title",
"description": "What is counted down to, or up from."
},
"target": {
"type": "string",
"format": "date-time",
"title": "Date",
"description": "The moment counted down to, or up from."
},
"asOf": {
"type": "string",
"format": "date-time",
"title": "As of",
"description": "The moment the time is counted from, usually when the post goes out. Never the clock: the clip shows the time left as of this moment."
},
"direction": {
"type": "string",
"enum": [
"until",
"since"
],
"title": "Direction",
"description": "Time left until the date, or time gone since it."
},
"precision": {
"type": "string",
"enum": [
"days",
"hours",
"minutes"
],
"title": "Smallest unit",
"description": "The smallest unit shown. Days alone suit anything weeks or more away."
},
"dateText": {
"type": "string",
"maxLength": 60,
"title": "Date in words",
"description": "How the date is written under the countdown. Left out, it is written from the date."
},
"note": {
"type": "string",
"maxLength": 140,
"title": "Context",
"description": "One or two lines under the date."
},
"more": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 80,
"title": "What is counted"
},
"target": {
"type": "string",
"format": "date-time",
"title": "The date"
},
"direction": {
"type": "string",
"enum": [
"until",
"since"
],
"title": "Direction",
"description": "Time left until the date, or time gone since it."
},
"dateText": {
"type": "string",
"maxLength": 60,
"title": "The date in words",
"description": "Left out, it is written from the date."
},
"note": {
"type": "string",
"maxLength": 140,
"title": "Context"
}
},
"required": [
"title",
"target"
],
"additionalProperties": false,
"title": "Date"
},
"minItems": 0,
"maxItems": 5,
"title": "More dates",
"description": "Further dates shown after the first, one at a time, each counted from the same moment and to the same precision. Each adds four seconds; five make a calendar of about 28 seconds."
},
"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 counted, the date and the moment counted from, how precisely, the date in words, a line of context, up to five more dates each on a page of its own, 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_7d1299a9e0ba?variant=Swiss%20grid&version=1.0.0"
Delivery JSON
Your own system sends this to one of your streams, POST /v1/stream, and every channel listening to
that stream draws it with its template. data is the document described above; a stream with an
empty field map passes it to the template unchanged. Try it first on POST /v1/stream/validate,
which answers the same without publishing anything. Streams and feeds
explains the rest, including how to map a document of your own shape instead.
{
"streamId": "st_your_stream_id",
"eventId": "01M2SQMKK3G1NVFXV31DCBVB95",
"occurredAt": "2026-09-23T07:00:00Z",
"locale": "en",
"data": {
"clipData": {
"kicker": "Rate watch",
"title": "Time left until the Northmark Central Bank announces its next decision on rates",
"target": "2026-10-08T14:00:00+02:00",
"asOf": "2026-10-06T09:30:00+02:00",
"direction": "until",
"precision": "minutes",
"dateText": "Thursday 8 October, 14:00 Northmark time",
"note": "Markets price a two in three chance of a quarter-point cut, which would be the first since the spring of 2024",
"more": [
{
"note": "Economists expect prices to have risen 2.3% on a year earlier",
"title": "Time left until Northmark publishes its inflation figures for September",
"target": "2026-10-14T08:00:00+02:00",
"dateText": "Wednesday 14 October, 08:00",
"direction": "until"
},
{
"title": "Time left until the quarterly results season opens",
"target": "2026-10-20T07:00:00+02:00",
"dateText": "Tuesday 20 October",
"direction": "until"
}
],
"source": "Northmark Central Bank calendar, market pricing at 09:30",
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto"
}
},
"metaData": {
"title": "2 days, 4 hours and 30 minutes until the Northmark Central Bank's next decision on interest rates",
"captionTiny": "The Northmark Central Bank announces its next rate decision on Thursday at 14:00. Markets price a two in three chance of a quarter-point cut, the first since the spring of 2024.",
"captionShort": "The Northmark Central Bank announces its next decision on interest rates on Thursday 8 October at 14:00 Northmark time, two days, four hours and thirty minutes from this morning. Markets price a two in three chance of a quarter-point cut, which would be the first since the spring of 2024. The governor speaks to the press half an hour after the announcement, and the bank publishes its new forecasts at the same time.",
"captionMedium": "The Northmark Central Bank announces its next decision on interest rates on Thursday 8 October at 14:00 Northmark time, two days, four hours and thirty minutes from this morning.\n\nMarkets price a two in three chance of a quarter-point cut, which would be the first since the spring of 2024. Inflation has fallen for five months in a row and stood at 2.3 percent in August, close to the bank's target of 2 percent, while unemployment has risen slightly over the summer.\n\nNot everybody expects a move. Two of the seven members of the rate committee said in September that they wanted to see the autumn wage agreements first, and the bank's own survey of businesses still shows prices rising faster in services than in goods.\n\nThe governor speaks to the press half an hour after the announcement, and the bank publishes its new forecasts for growth and inflation at the same time. The minutes of the meeting follow two weeks later.\n\nThe times are the bank's own calendar; the market pricing is from this morning at 09:30.",
"captionLong": "The Northmark Central Bank announces its next decision on interest rates on Thursday 8 October at 14:00 Northmark time, two days, four hours and thirty minutes from this morning.\n\nMarkets price a two in three chance of a quarter-point cut, which would be the first since the spring of 2024. Inflation has fallen for five months in a row and stood at 2.3 percent in August, close to the bank's target of 2 percent, while unemployment has risen slightly over the summer, from 4.1 to 4.4 percent.\n\nNot everybody expects a move. Two of the seven members of the rate committee said in September that they wanted to see the autumn wage agreements first, and the bank's own survey of businesses still shows prices rising faster in services than in goods. A decision to wait would not surprise most economists, but it would move the currency and the bond market, which have both been priced for a cut for several weeks.\n\nWhat a cut would mean: variable mortgage rates would follow within days at most banks, and savings rates usually a little later. Fixed-rate loans would not change until they are renewed.\n\nThe governor speaks to the press half an hour after the announcement, and the bank publishes its new forecasts for growth and inflation at the same time. The minutes of the meeting, which say how each member voted, follow two weeks later.\n\nThe times are the bank's own calendar; the market pricing is from this morning at 09:30. Nothing in this clip is investment advice.",
"hashtags": [
"NorthmarkCentralBank",
"interestrates",
"ratedecision",
"inflation",
"countdown",
"markets",
"economy",
"mortgages",
"monetarypolicy",
"finance"
]
}
}
}
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.