Picture with pins
One picture, a map, a plan, a view or a product, with up to six numbered pins landing on their spots, each named on the picture and explained in a list beside it, and a route drawn across it where you send one: 8 to 17 seconds. In fourteen styles, each wearing your brand's colours, fonts, logo, presenter and background.
| Template id | tpl_8789d35d3793 |
|---|---|
| Markets | Every market |
| Variants | Corporate glass, Bento grid, Broadcast news, Editorial, Swiss grid, Neo-brutalist, Soft friendly, Clear civic, Keynote minimal, Outline, Infinite zoom, Hand marks, Deco lines, Constructivist |
| Ready-made feeds | 88, listed below |
Use cases
- A walk, a route, a venue plan or a site map with its places numbered and named.
- A product with its features pinned on the picture and explained in a list beside it.
- Up to six pins on one picture from your media library, and a route drawn across it.
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 |
| Keynote minimal | A launch stage: one thing at a time, huge type and a light sweep in your colour. | 1 | 1.0.0 |
| Outline | Everything drawn as a line in your colours: outlined cards and bars that draw themselves on, only what matters filled solid. | 1 | 1.0.0 |
| Infinite zoom | Nested frames in your colours and one continuous push in: every part grows out of the middle, never a cut. | 1 | 1.0.0 |
| Hand marks | A clean page with a marker in your colours: loops, underlines and ticks drawn on over clean type. | 1 | 1.0.0 |
| Deco lines | Art Deco panels in your colours: cut corners in fine parallel lines, mirrored fans on a deep ground. | 1 | 1.0.0 |
| Constructivist | A 1920s poster in your colours: hard diagonals, heavy bars and wedges, type set on a slant. | 1 | 1.0.0 |
What it accepts
Every variant takes the same content, so one document draws in any of them.
One picture, a map, a plan, a view or a product, with up to six numbered pins placed on it by position, their names beside them, an optional route drawn across it and a note for every pin in a list beside the picture. 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, the title, the picture and how it is fitted, the pins (where, a name and a note), an optional route with what it is, the source and the look. Positions are percentages of the picture's own width and height from its top left corner, so a pin stays on its spot whatever the frame. | |
clipData.kicker | text | up to 20 characters | Kicker: A word above the title, such as DIVERSION, HALL 4 or TRAIL GUIDE. | |
clipData.title | text | yes | up to 80 characters | Title: What the picture shows and why it is pinned. Shown from the first frame. |
clipData.picture | video | yes | media:// picture or video from the media library, alt text up to 120 characters | Picture or video: A map, a floor plan, a view or a product from the media library. The pins are placed on it by position. A video from the media library plays in its place, without its sound, and from its start again whenever it ends. |
clipData.pictureFit | enum | fill, whole | Picture fit: Fill the frame for a photograph or a view: the frame may trim its edges, never past a pin or the route. Show it whole for a map or a plan whose edges matter. | |
clipData.pins | list | yes | at least 1, up to 6 | Pins: One to six, numbered in the order sent and arriving one at a time, each with its name beside it on the picture where there is room and its note in the list. Each adds a little over two seconds. |
clipData.pins[] | group | Pin | ||
clipData.pins[].x | number | yes | from 0, to 100, 2 decimals | Across, %: From 0 at the picture's left edge to 100 at its right. |
clipData.pins[].y | number | yes | from 0, to 100, 2 decimals | Down, %: From 0 at the picture's top edge to 100 at its bottom. |
clipData.pins[].label | text | yes | up to 28 characters | Name: Written beside the pin on the picture where there is room, and in the list. |
clipData.pins[].note | text | up to 90 characters | Note: Written under the name in the list. | |
clipData.route | list | up to 16 | Route: Two to sixteen points, drawn as one line in the order sent before the pins arrive. Left out, no route is drawn. | |
clipData.route[] | group | Point | ||
clipData.route[].x | number | yes | from 0, to 100, 2 decimals | Across, % |
clipData.route[].y | number | yes | from 0, to 100, 2 decimals | Down, % |
clipData.routeLabel | text | up to 40 characters | What the route is: Written beside a sample of the line, above the list. | |
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_8789d35d3793?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": "Walk of the week",
"title": "Saturday's ridge walk: three summits in a day, and where to stop on the way",
"picture": {
"alt": "Three snow-capped peaks above green foothills under an evening sky",
"url": "media://example-image.svg"
},
"pictureFit": "fill",
"pins": [
{
"x": 9.17,
"y": 91.85,
"note": "Meet at 8:30 by the noticeboard; the car park fills early on Saturdays",
"label": "Mill Lane car park"
},
{
"x": 14.17,
"y": 48.89,
"note": "The first climb, about an hour, and the steepest part of the day",
"label": "Grey Crag"
},
{
"x": 37.5,
"y": 42.96,
"note": "The highest point of the walk and the lunch stop, with views over the whole valley",
"label": "High Pike"
},
{
"x": 63.33,
"y": 50.37,
"note": "The last summit, then a gentle path down through the woods",
"label": "Eastern Top"
},
{
"x": 83.33,
"y": 93.33,
"note": "Bus 21 back to Mill Lane every 30 minutes until 7 pm",
"label": "Riverside bus stop"
}
],
"route": [
{
"x": 9.17,
"y": 91.85
},
{
"x": 10.83,
"y": 69.63
},
{
"x": 14.17,
"y": 49.78
},
{
"x": 25,
"y": 66.07
},
{
"x": 37.5,
"y": 43.85
},
{
"x": 50.83,
"y": 69.04
},
{
"x": 63.33,
"y": 51.26
},
{
"x": 70.83,
"y": 68.15
},
{
"x": 77.5,
"y": 82.96
},
{
"x": 83.33,
"y": 93.33
}
],
"routeLabel": "The walk, about 14 km and six hours",
"source": "Source: Valley walking group, autumn route card",
"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": "Saturday's ridge walk: three summits in a day, from Mill Lane to the river",
"captionTiny": "Saturday's ridge walk takes in Grey Crag, High Pike and Eastern Top: about 14 km and six hours, from Mill Lane car park to the riverside bus stop.",
"captionShort": "Saturday's ridge walk climbs three summits in one day. We meet at 8:30 at Mill Lane car park, climb Grey Crag first (the steepest hour of the day), stop for lunch on High Pike, the highest point, and finish over Eastern Top before a gentle path down through the woods. Bus 21 runs back to Mill Lane from the riverside stop every 30 minutes until 7 pm. About 14 km and six hours.",
"captionMedium": "Saturday's ridge walk takes in three summits in one day, about 14 km and six hours on foot.\n\nWe meet at 8:30 by the noticeboard at Mill Lane car park, which fills early on Saturdays. The first climb, up Grey Crag, takes about an hour and is the steepest part of the day. From there the path follows the ridge to High Pike, the highest point of the walk and our lunch stop, with views over the whole valley.\n\nEastern Top is the last summit, and after it a gentle path leads down through the woods to the river. Bus 21 runs from the riverside stop back to Mill Lane every 30 minutes until 7 pm.\n\nBring water, a warm layer and boots with a good grip.",
"captionLong": "Saturday's ridge walk takes in three summits in one day, about 14 km and six hours on foot, with plenty of time for stops.\n\nWe meet at 8:30 by the noticeboard at Mill Lane car park. It fills early on Saturdays, so come in good time or take the first bus.\n\nThe first climb, up Grey Crag, takes about an hour and is the steepest part of the day; we go at the pace of the slowest walker. From there the path follows the ridge to High Pike, the highest point of the walk and our lunch stop, with views over the whole valley on a clear day.\n\nEastern Top is the last summit. After it a gentle path leads down through the woods to the river, where the walk ends at the riverside bus stop. Bus 21 runs back to Mill Lane every 30 minutes until 7 pm.\n\nBring water, lunch, a warm layer and boots with a good grip. If the weather turns, we take the lower path below the ridge, and we post any change here by Friday evening.",
"hashtags": [
"ridgewalk",
"hiking",
"walkingroute",
"outdoors",
"weekend"
]
}
}
}
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.
- Air quality in Austria (Picture with pins)
- Air quality in Belgium (Picture with pins)
- Air quality in Italy (Picture with pins)
- Air quality in Poland (Picture with pins), Live data
- Air quality in Poland (Picture with pins), Official data
- Air quality in Spain (Picture with pins)
- Air quality in Switzerland (Picture with pins)
- Air quality in the Netherlands (Picture with pins)
- Air quality in the United Kingdom (Picture with pins), Live data
- Air quality in the United Kingdom (Picture with pins), Official data
- Air quality today (Picture with pins)
- Aurora alert (Picture with pins), Live data
- Aurora alert (Picture with pins), Official data
- Cross-border flow clip (Picture with pins)
- Flood-stage alert (Picture with pins), Live data
- Flood-stage alert (Picture with pins), Official data
- Fuel prices in Austria (Picture with pins), Live data
- Fuel prices in Austria (Picture with pins), Official data
- Fuel prices in France (Picture with pins), Live data
- Fuel prices in France (Picture with pins), Official data
- Fuel prices in Mexico (Picture with pins), Live data
- Fuel prices in Mexico (Picture with pins), Official data
- Fuel prices in Portugal (Picture with pins), Live data
- Fuel prices in Portugal (Picture with pins), Official data
- Fuel prices in Spain (Picture with pins), Live data
- Fuel prices in Spain (Picture with pins), Official data
- Heat and cold warnings (Picture with pins)
- Kp index today (Picture with pins), Live data
- Kp index today (Picture with pins), Official data
- Rhine water levels (Picture with pins), Live data
- Rhine water levels (Picture with pins), Official data
- Severe weather warnings in France (Picture with pins), Live data
- Severe weather warnings in France (Picture with pins), Official data
- Severe weather warnings in Germany (Picture with pins), Live data
- Severe weather warnings in Germany (Picture with pins), Official data
- Severe weather warnings in Spain (Picture with pins), Live data
- Severe weather warnings in Spain (Picture with pins), Official data
- Severe weather warnings in the United Kingdom (Picture with pins), Live data
- Severe weather warnings in the United Kingdom (Picture with pins), Official data
- Severe weather warnings in the United States (Picture with pins), Live data
- Severe weather warnings in the United States (Picture with pins), Official data
- Solar flare note (Picture with pins), Live data
- Solar flare note (Picture with pins), Official data
- Threshold-exceeded alert (Picture with pins), Live data
- Threshold-exceeded alert (Picture with pins), Official data
- Today's weather in Argentina (Picture with pins)
- Today's weather in Australia (Picture with pins)
- Today's weather in Austria (Picture with pins)
- Today's weather in Belgium (Picture with pins)
- Today's weather in Brazil (Picture with pins)
- Today's weather in Canada (Picture with pins)
- Today's weather in Denmark (Picture with pins)
- Today's weather in Egypt (Picture with pins)
- Today's weather in France (Picture with pins)
- Today's weather in Germany (Picture with pins)
- Today's weather in India (Picture with pins)
- Today's weather in Indonesia (Picture with pins)
- Today's weather in Ireland (Picture with pins)
- Today's weather in Italy (Picture with pins)
- Today's weather in Japan (Picture with pins)
- Today's weather in Kenya (Picture with pins)
- Today's weather in Mexico (Picture with pins)
- Today's weather in Nigeria (Picture with pins)
- Today's weather in Poland (Picture with pins)
- Today's weather in Portugal (Picture with pins)
- Today's weather in Saudi Arabia (Picture with pins)
- Today's weather in Singapore (Picture with pins)
- Today's weather in South Africa (Picture with pins)
- Today's weather in South Korea (Picture with pins)
- Today's weather in Spain (Picture with pins)
- Today's weather in Sweden (Picture with pins)
- Today's weather in Switzerland (Picture with pins)
- Today's weather in the Netherlands (Picture with pins)
- Today's weather in the Philippines (Picture with pins)
- Today's weather in the United Arab Emirates (Picture with pins)
- Today's weather in the United Kingdom (Picture with pins)
- Today's weather in the United States (Picture with pins)
- UV index in France (Picture with pins)
- UV index in Italy (Picture with pins)
- UV index in Mexico (Picture with pins)
- UV index in Spain (Picture with pins), Live data
- UV index in Spain (Picture with pins), Official data
- UV index in the United Kingdom (Picture with pins)
- UV index in the United States (Picture with pins), Live data
- UV index in the United States (Picture with pins), Official data
- UV index today (Picture with pins), Live data
- UV index today (Picture with pins), Official data
- Viewing conditions (Picture with pins)