Tech and industry (Energy and utilities), Planned maintenance
Water, gas or power off for planned works as a departures board: what is off beside a lamp, the date and the hours on flaps, up to eight areas as rows with their lamps (areas, never an address), what to do before, then the line to call on flaps, the button and the presenter, the supplier's notice at the foot throughout. Complete on the first frame. Eight seconds, and about one more for every area.
| Template | Tech and industry (Energy and utilities), tpl_1aa6650d866f |
|---|---|
| Variant | Planned maintenance |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 13 seconds |
Example video
The 1x1 cut of this variant, drawn from its own worked example. Open the video on its own.
What it accepts
Water, gas or power off for planned works as a departures board: what is off, the date and the hours on flaps, up to eight areas as rows with a lamp, what to do before, then the line to call, the button and your presenter. Your notice stays at the foot throughout. Areas only, never an address. Eight seconds, and 0.9 more per area. metaData is never drawn.
| Field | Type | Required | Limit | What it is |
|---|---|---|---|---|
clipData | group | yes | Clip data: Everything drawn in the clip: what is off, the dates and hours, the areas and where in them, the steps before, the line to call, the words on the board, the call to action, your notice and the small print. | |
clipData.section | text | up to 24 characters | Section: The section in the header, painted as a sign beside your title line, such as Planned works. | |
clipData.kicker | text | up to 40 characters | Kicker: A short line above the headline, such as Water supply. | |
clipData.headline | text | yes | up to 80 characters | Headline: The headline, set large. Say what is off, where and when, as plainly as you can. |
clipData.service | text | yes | up to 32 characters | What is off: What is switched off, such as Water supply off, Gas supply off or Power off. Shown beside a lamp in the panel on every frame. |
clipData.from | datetime | yes | From: When the works start, such as 2026-11-03T09:00:00+01:00. The date and the clock time are read as written here, never moved by a time zone, and shown the channel's way. | |
clipData.until | datetime | yes | Until: When the supply is back, such as 2026-11-03T15:00:00+01:00. On the same day as the start only the date is shown once; on another day the date range is shown. | |
clipData.areas | list | yes | at least 1, up to 8 | Areas: One to eight areas affected, in the order they are told: a district, a village or a postcode range, and where useful the streets by name. Never a single address or a house number. All are listed on the first frame (a long list is shown in pages), then each is told in turn. |
clipData.areas[] | group | Area | ||
clipData.areas[].area | text | yes | up to 40 characters | Area: The district, village or postcode range, such as Weststadt. |
clipData.areas[].where | text | up to 60 characters | Where in it: Streets by name or a postcode range, never a house number or one address. | |
clipData.steps | list | up to 4 | What to do before: Up to four short things to do before the works, one sentence each, such as filling containers with water. Told after the areas. | |
clipData.steps[] | text | up to 100 characters | Step | |
clipData.line | group | The line to call: The number to call, shown at the end on flaps as written, with its caption. | ||
clipData.line.label | text | up to 40 characters | Caption: What the number is for, such as Customer line, open 24 hours. | |
clipData.line.number | text | yes | up to 24 characters | Number: The number exactly as it should be dialled, such as 0800 555 0123. |
clipData.labels | group | Words on the board: The words the board shows over the figures, in your language. A word left out is not drawn; its part still is. | ||
clipData.labels.hours | text | up to 16 characters | Over the hours: The caption over the hours, such as Hours. | |
clipData.labels.areas | text | up to 32 characters | Over the areas: The heading over the areas, such as Areas and where in them. | |
clipData.labels.before | text | up to 24 characters | Over what to do: The caption over the steps, such as Before the works. | |
clipData.cta | group | Call to action: The button at the end and the line under it, such as a web address, a handle or a phone number. | ||
clipData.cta.label | text | yes | up to 28 characters | Button: What the button says. |
clipData.cta.detail | text | up to 48 characters | Line under it: An address, a handle, an app, a phone number. | |
clipData.notice | text | yes | up to 300 characters | Notice: Who supplies and that times can change; only areas are named. Shown at the foot from the first frame to the last; a long notice is set smaller, never cut. |
clipData.footnote | text | up to 200 characters | Small print: Any other line that must be shown, such as help for customers who rely on medical equipment. | |
clipData.look | group | Look: How the clip looks and moves. The same six switches in every format (theme, pace, corners, alignment, logo, logo size). Leave any out for the package's default: dark, standard pace, softly rounded, text at the start. | ||
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.logo | enum | auto, free | Logo: The style's own: the logo on a small plate 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. | |
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. | |
metaData | group | Meta data: Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data. | ||
metaData.title | text | up to 100 characters | Title: Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes. | |
metaData.captionTiny | text | up to 200 characters | Tiny description (Pinterest, Threads, X): Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionShort | text | up to 500 characters | Short description (Telegram, Threema, WeChat, WhatsApp): Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionMedium | text | up to 1500 characters | Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok): Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionLong | text | up to 4000 characters | Long description (Facebook Feed, YouTube): Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.hashtags | list | up to 15 | Hashtags: Written without the #. Up to 15, which every platform takes. | |
metaData.hashtags[] | text | up to 60 characters | Hashtag |
locales carries other languages: under each language code, the parts of clipData and metaData that differ, laid over the default, so a language with no copy still renders.
A picture is always a file from your media library: media:// followed by its id or its name.
Anything the table does not list is refused, and so is anything over its limit, with a 400
schema_validation error that names the field.
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_1aa6650d866f?variant=Planned%20maintenance&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": {
"section": "Planned works",
"kicker": "Water supply",
"headline": "Water will be off in the west of the city on 3 November",
"service": "Water supply off",
"from": "2026-11-03T09:00:00+01:00",
"until": "2026-11-03T15:00:00+01:00",
"areas": [
{
"area": "Weststadt",
"where": "Postcodes 04109 to 04129"
},
{
"area": "Grünau",
"where": "Lindenstrasse and side streets"
},
{
"area": "Neuhof",
"where": "Between the ring road and the canal"
},
{
"area": "Alte Mühle",
"where": "Mühlweg and Bahnhofstrasse"
},
{
"area": "Lindenau-Mitte",
"where": "Postcodes 04177 and 04179"
},
{
"area": "Leutzsch",
"where": "North of Georg-Schwarz-Strasse"
}
],
"steps": [
"Fill a few containers with drinking water the evening before.",
"Switch off the washing machine and the dishwasher while the works last.",
"Run the taps for a minute once the water is back."
],
"line": {
"label": "Customer line, open 24 hours",
"number": "0800 555 0123"
},
"labels": {
"areas": "Areas and where in them",
"hours": "Hours",
"before": "Before the works"
},
"cta": {
"label": "See the works page",
"detail": "stadtwerke-lindenau.example/works"
},
"notice": "Stadtwerke Lindenau GmbH, supplier of water, gas and electricity. Planned times can change; the works page shows the latest. Only areas are named here, never an address.",
"footnote": "Customers who rely on medical equipment that needs water or power: call the customer line and we will arrange support.",
"look": {
"logo": "auto",
"pace": "standard",
"align": "start",
"theme": "dark",
"corners": "soft",
"logoSize": "auto"
}
},
"metaData": {
"title": "Planned works: water off in the west of the city on 3 November",
"captionTiny": "Water will be off on 3 November from 9:00 to 15:00 in Weststadt, Grünau, Neuhof and more. Call 0800 555 0123.",
"captionShort": "Planned works: the water will be off on Tuesday 3 November from 9:00 to 15:00 in Weststadt, Grünau, Neuhof, Alte Mühle, Lindenau-Mitte and Leutzsch. Fill a few containers the evening before. Customer line, open 24 hours: 0800 555 0123.",
"captionMedium": "Planned works on Tuesday 3 November: the water supply will be off from 9:00 to 15:00 in Weststadt, Grünau, Neuhof, Alte Mühle, Lindenau-Mitte and Leutzsch. Before then, fill a few containers with drinking water, switch off the washing machine and the dishwasher while the works last, and run the taps for a minute once the water is back. Our customer line is open 24 hours on 0800 555 0123. Planned times can change; the works page shows the latest.",
"captionLong": "Planned works on Tuesday 3 November: the water supply will be off from 9:00 to 15:00 in Weststadt (postcodes 04109 to 04129), Grünau (Lindenstrasse and side streets), Neuhof (between the ring road and the canal), Alte Mühle (Mühlweg and Bahnhofstrasse), Lindenau-Mitte (postcodes 04177 and 04179) and Leutzsch (north of Georg-Schwarz-Strasse). Before then, fill a few containers with drinking water the evening before, switch off the washing machine and the dishwasher while the works last, and run the taps for a minute once the water is back. Customers who rely on medical equipment that needs water or power should call the customer line, open 24 hours, on 0800 555 0123, and we will arrange support. Planned times can change; the works page shows the latest. Stadtwerke Lindenau GmbH.",
"hashtags": [
"watersupply",
"plannedworks",
"utilities",
"stadtwerke",
"service"
]
}
}
}
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.