Progress
A share of a whole: a bar or a ring filling while the percent counts up to the value's share of the total, a target marked on it and a change, then up to three more, one at a time: 8 to 22 seconds. In twelve styles, each wearing your brand's colours, fonts, logo, presenter and background.
| Template id | tpl_05f0066f69c0 |
|---|---|
| Markets | Every market |
| Variants | Corporate glass, Bento grid, Broadcast news, Editorial, Swiss grid, Neo-brutalist, Soft friendly, Clear civic, Lock screen, Keynote minimal, Data terminal, Sketch notes |
| Ready-made feeds | 25, listed below |
Use cases
- How far something has got: a fundraiser, a building project, a target, a share of seats sold.
- A share of a whole as a bar or a ring, with a target marked on it.
- Up to four shares in one post, such as the parts of a budget.
Variants
A variant is this template drawn another way, and it comes in versions: immutable builds, the newest first. A channel follows the newest version of its variant, unless it is pinned to one.
| Variant | What it is | Versions | Newest |
|---|---|---|---|
| Corporate glass | Frosted glass cards over an aurora in your brand colours: calm and premium. | 1 | 1.0.0 |
| Bento grid | Rounded tiles in your brand colours, each moving on its own: a modern product look. | 1 | 1.0.0 |
| Broadcast news | A news channel in your colours: channel bug, lower third, ticker and your presenter. | 1 | 1.0.0 |
| Editorial | A magazine page in your paper tone and serif: masthead, hairline rules and a byline. | 1 | 1.0.0 |
| Swiss grid | A strict grid, large type and your brand colour as the one accent. Nothing bounces. | 1 | 1.0.0 |
| Neo-brutalist | Loud flat blocks in your colours with thick borders and hard shadows. | 1 | 1.0.0 |
| Soft friendly | Soft shapes and rounded cards in tints of your brand colour: warm and approachable. | 1 | 1.0.0 |
| Clear civic | Built for reading: high contrast, large plain type and numbered steps. | 1 | 1.0.0 |
| Lock screen | A phone's lock screen on your wallpaper, the news arriving as notifications from your app. | 1 | 1.0.0 |
| Keynote minimal | A launch stage: one thing at a time, huge type and a light sweep in your colour. | 1 | 1.0.0 |
| Data terminal | A market terminal whose ink is your brand colour, the figures scrambling into place. | 1 | 1.0.0 |
| Sketch notes | A notebook page that writes and doodles itself in your brand ink. | 1 | 1.0.0 |
What it accepts
Every variant takes the same content, so one document draws in any of them.
A share of a whole: a bar or a ring filling to the value's share of the total while the percent counts up, with an optional target marked on it and a change, and up to three more after it, one at a time. For reservoir levels, a year's progress, turnout, a fundraiser. 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 filling, the value and its total, the shape, a target, a change, a line of context, up to three more 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 UPDATE or THIS YEAR. | |
clipData.title | text | yes | up to 80 characters | Title: What is filling, and towards what. |
clipData.value | number | yes | from 0, 4 decimals | Value: How much there is, in the unit. |
clipData.total | number | yes | from 0, 4 decimals | Total: The whole, in the same unit. The percent shown is the value's share of it, rounded down. |
clipData.unit | text | up to 16 characters | Unit: Written after the value and the total: million m³, seats, days, euros. | |
clipData.shape | enum | bar, ring | Shape: A bar filling from left to right, or a ring filling clockwise from the top. | |
clipData.target | group | Target: A mark on the bar or ring: a goal, a threshold, last year's level. Left out, none is drawn. | ||
clipData.target.value | number | yes | from 0, 4 decimals | Value: In the same unit as the value. |
clipData.target.label | text | up to 30 characters | Label | |
clipData.change | group | Change: A change shown under the figures in green or red. Left out, none is shown. | ||
clipData.change.value | number | yes | 4 decimals | Change |
clipData.change.unit | text | up to 8 characters | Unit: Such as points or %. | |
clipData.change.label | text | up to 40 characters | Since when | |
clipData.note | text | up to 140 characters | Context: One or two lines of context. | |
clipData.more | list | at least 0, up to 3 | More shares: Further shares shown after the first, one at a time, each with what it is, its value and total, a target and a change. The shape is the first one's. Each adds four and a half seconds. | |
clipData.more[] | group | Share | ||
clipData.more[].title | text | yes | up to 80 characters | Title: What is filling, and towards what. |
clipData.more[].value | number | yes | from 0, 4 decimals | Value: How much there is, in the unit. |
clipData.more[].total | number | yes | from 0, 4 decimals | Total: The whole, in the same unit. The percent shown is the value's share of it, rounded down. |
clipData.more[].unit | text | up to 16 characters | Unit: Written after the value and the total: million m³, seats, days, euros. | |
clipData.more[].target | group | Target: A mark on the bar or ring: a goal, a threshold, last year's level. Left out, none is drawn. | ||
clipData.more[].target.value | number | yes | from 0, 4 decimals | Value: In the same unit as the value. |
clipData.more[].target.label | text | up to 30 characters | Label | |
clipData.more[].change | group | Change: A change shown under the figures in green or red. Left out, none is shown. | ||
clipData.more[].change.value | number | yes | 4 decimals | Change |
clipData.more[].change.unit | text | up to 8 characters | Unit: Such as points or %. | |
clipData.more[].change.label | text | up to 40 characters | Since when | |
clipData.more[].note | text | up to 140 characters | Context: One or two lines of context. | |
clipData.source | text | up to 70 characters | Source: Where the content comes from, shown small at the foot. Drawn exactly as written: write its label too, such as Source: at the start, as the template adds no word of its own. | |
clipData.styleWords | group | Style words: The few words some styles write into their own frame, each drawn exactly as written, in the language you write it in. A word left out is not drawn: no template adds a word of its own. The same keys in every format of the collections; each style draws only its own. | ||
clipData.styleWords.live | text | up to 16 characters | Live marker (Broadcast news): Written beside the light in Broadcast news' channel bug, such as LIVE. Left out, the light stands alone. | |
clipData.styleWords.byline | text | up to 12 characters | Byline (Editorial): Written before the presenter's name in Editorial, such as By. Left out, the name stands alone. | |
clipData.styleWords.functionKeys | list | up to 4 | Function keys (Data terminal): Data terminal's row of keys F1 to F4, one word each, in order, such as HELP, DATA, CHART and NEWS; the second is drawn held down, and a key that does not fit the row is left out. Left out, no keys are drawn. | |
clipData.styleWords.functionKeys[] | text | up to 12 characters | Key | |
clipData.styleWords.commandKey | text | up to 10 characters | Command key (Data terminal): The key at the end of Data terminal's row, in the rise colour, such as GO. Left out, none is drawn. | |
clipData.styleWords.realTime | text | up to 12 characters | Real-time light (Data terminal): Written beside the blinking light in Data terminal's status bar, such as RT. Left out, the light stands alone. | |
clipData.styleWords.messageLabel | text | up to 12 characters | Message window label (Data terminal): The tab on Data terminal's message window round the presenter, such as MSG. Left out, the window has no tab. | |
clipData.styleWords.pictureLabel | text | up to 12 characters | Picture panel label (Data terminal): Written in the strip along the top of Data terminal's picture panels, such as IMG. Left out, the strip stays empty. | |
clipData.look | group | Look: How the clip looks and moves within its style. The same 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, or your brand's Theme where it sets one; 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, light, dark, brand | Logo: The style's own: the logo on the style's plate, or where it would not read there, on a light or a dark plate, or your logo for dark surfaces where your brand has one. As it is: no plate, frame or crop; make sure it reads on the theme you choose. On a light, dark or brand colour plate: that plate in every style, also where the style draws none. | |
clipData.look.logoSize | enum | auto, small, large | Logo size: Standard is the style's own size. Small draws the logo a fifth smaller, with its plate. Large draws it a quarter larger wherever the style has room for it, and at the standard size where it has none. | |
clipData.look.logoForm | enum | auto, mark, full | Logo form: The style's own: your brand's mark (its symbol alone, set in your brand's settings) where the style's logo space is round or a badge, or where a wide logo would have to be made much smaller to fit; the full logo everywhere else. Mark: always the mark. Full logo: never the mark. A brand without a mark always shows its full logo. | |
clipData.look.hideHeader | boolean | Hide logo and title: Leaves out the line at the top of the clip: your logo, the title line and the style's decoration around them, so the content starts at the top. To leave it out of every clip, switch Logo and title line off in your brand's settings. | ||
clipData.look.hideFooter | boolean | Hide footer line: Leaves out your footer line at the foot of the clip, with whatever the style draws only to carry it, so the content reaches further down. Your presenter and the source line stay. To leave it out of every clip, switch Footer line off in your brand's settings. | ||
clipData.look.pattern | enum | auto, none, dots, grid, lines | Background pattern: The fine texture behind the content. The style's own keeps what the style draws there, and some styles draw none. None leaves the background plain. Dots, Grid and Diagonal lines draw that pattern faintly instead, the same in every style, in the colour of your page. | |
clipData.look.background | boolean | Brand background: Draws your brand's background picture or film behind the content under any theme, under a veil of the theme's page so the words stay readable. Under Brand colours it is always drawn. It needs a background switched on in your brand's settings; without one, the theme's plain page is drawn. | ||
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 Reels, 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): 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, 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.
Ask Reelwire for the whole JSON Schema, the document your content is checked against, without signing in:
curl "https://app.reelwire.io/v1/formats/template/tpl_05f0066f69c0?variant=Corporate%20glass&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": "Water supply",
"title": "How full the Harlow Valley reservoirs are after the driest September since 2018",
"value": 412.3,
"total": 675,
"unit": "million m³",
"shape": "ring",
"target": {
"label": "Garden hosepipe ban below",
"value": 405
},
"change": {
"unit": "points",
"label": "since 1 September",
"value": -9
},
"note": "The rain forecast for next week would add about two points. The water board asks every household to save water where it can.",
"more": [
{
"note": "North Fell feeds the hill villages and falls fastest in a dry month.",
"unit": "million m³",
"title": "How full the North Fell reservoir is, the smallest of the three",
"total": 92,
"value": 38.6,
"change": {
"unit": "points",
"label": "since 1 September",
"value": -12
}
}
],
"source": "Source: Harlow Valley Water Board, daily gauge readings",
"styleWords": {
"live": "LIVE",
"byline": "By",
"functionKeys": [
"HELP",
"DATA",
"CHART",
"NEWS"
],
"commandKey": "GO",
"realTime": "RT",
"messageLabel": "MSG",
"pictureLabel": "IMG"
},
"look": {
"theme": "auto",
"pace": "auto",
"corners": "auto",
"align": "auto",
"logo": "auto",
"logoSize": "auto",
"logoForm": "auto",
"hideHeader": false,
"hideFooter": false,
"pattern": "auto",
"background": false
}
},
"metaData": {
"title": "Harlow Valley reservoirs 61 percent full, one point above the level that triggers a hosepipe ban",
"captionTiny": "The Harlow Valley reservoirs are 61 percent full after the driest September since 2018, down nine points in a month and one point above the level that would trigger a garden hosepipe ban.",
"captionShort": "The Harlow Valley reservoirs hold 412 million cubic metres of water, 61 percent of what they can hold, after the driest September since 2018. That is nine points lower than on 1 September and one point above the 60 percent level at which the water board would ban garden hosepipes. The rain forecast for next week would add about two points. The water board asks every household to save water where it can.",
"captionMedium": "The Harlow Valley reservoirs hold 412 million cubic metres of water this morning, 61 percent of what the four lakes can hold together. It follows the driest September since 2018, with less than a third of the month's usual rain.\n\nThe level has fallen by nine points since 1 September, and it is now one point above the 60 percent at which the water board would ban the use of garden hosepipes and sprinklers across the valley. Drinking water is not at risk: the board says supply is secure well into next year even if the dry spell continues.\n\nThe rain forecast for next week would add about two points. Until then the board asks every household to save water where it can: shorter showers, full loads in the washing machine and dishwasher, and no washing cars with a hose.\n\nThe figures come from the board's daily gauge readings at the four dams and are published every morning at 08:00.",
"captionLong": "The Harlow Valley reservoirs hold 412 million cubic metres of water this morning, 61 percent of what the four lakes can hold together. It follows the driest September since 2018, with less than a third of the month's usual rain falling on the hills that feed them.\n\nThe level has fallen by nine points since 1 September, and it is now one point above the 60 percent at which the water board would ban the use of garden hosepipes and sprinklers across the valley. A ban would apply to households and gardens; farms and businesses have their own rules and are not affected by it.\n\nDrinking water is not at risk. The board says supply is secure well into next year even if the dry spell continues, because the largest lake, Harlow Water, is still above three quarters full and the pipeline from the northern springs can carry more than it does now.\n\nThe rain forecast for next week would add about two points. Until then the board asks every household to save water where it can: shorter showers, full loads in the washing machine and dishwasher, a bowl rather than a running tap for vegetables, and no washing cars with a hose. Leaks can be reported on the board's free number at any time of day.\n\nThe last hosepipe ban in the valley was in the summer of 2018, when the reservoirs fell to 48 percent and the ban stayed in place for eleven weeks.\n\nThe figures come from the board's daily gauge readings at the four dams and are published every morning at 08:00.",
"hashtags": [
"HarlowValley",
"reservoirs",
"water",
"drought",
"savewater",
"weather",
"hosepipeban",
"September",
"waterboard",
"localnews"
]
}
}
}
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.
Ready-made feeds drawn with it
Each of these feeds is drawn with this template, in whichever of its variants a channel chooses when it adds the feed.
- Bitcoin dominance (Progress)
- Days remaining card (Progress), Live data
- Days remaining card (Progress), Official data
- Renewable share milestone in Germany (Progress)
- Renewable share yesterday (Progress)
- Renewable share yesterday in Austria (Progress)
- Renewable share yesterday in Belgium (Progress)
- Renewable share yesterday in Denmark (Progress)
- Renewable share yesterday in France (Progress)
- Renewable share yesterday in Great Britain (Progress), Live data
- Renewable share yesterday in Great Britain (Progress), Official data
- Renewable share yesterday in Italy (Progress)
- Renewable share yesterday in Norway (Progress)
- Renewable share yesterday in Poland (Progress)
- Renewable share yesterday in Portugal (Progress)
- Renewable share yesterday in Spain (Progress), Live data
- Renewable share yesterday in Spain (Progress), Official data
- Renewable share yesterday in Sweden (Progress)
- Renewable share yesterday in Switzerland (Progress)
- Renewable share yesterday in the European Union (Progress)
- Renewable share yesterday in the Netherlands (Progress)
- Week and quarter marker (Progress), Live data
- Week and quarter marker (Progress), Official data
- Year progress (Progress), Live data
- Year progress (Progress), Official data