This or that
One question and two options face to face, a picture and a name each; the word between them lands, the audience's share of each fills its bar only where it is sent and the larger one is lit, then the question is handed to the viewer; up to three more pairs, a page each: 8 to 23 seconds. In eight styles, each wearing your brand's colours, fonts, logo, presenter and background.
| Template id | tpl_f29263ec9236 |
|---|---|
| Markets | Every market |
| Variants | Corporate glass, Bento grid, Broadcast news, Editorial, Swiss grid, Neo-brutalist, Soft friendly, Creator native |
| Ready-made feeds | None |
Use cases
- Two options face to face for your audience to choose: products, designs, plans or habits.
- A poll's result, each option's share shown exactly as you send it, the larger one lit.
- Up to four pairs in one video, a page each, with your question to the viewer at the end.
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 |
| Creator native | Made in the app: your picture behind text boxes and captions in your colour. | 1 | 1.0.0 |
What it accepts
Every variant takes the same content, so one document draws in any of them.
This or that: a question and two options face to face, a picture and a name each, the audience's share of each only where it is sent, then the question handed to the viewer; up to three more pairs, a page each. 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: the question, the two options, the word between them, the ask, the source, further pairs and the look. | |
clipData.kicker | text | up to 20 characters | Kicker: A word or two above the question, such as THIS OR THAT? | |
clipData.question | text | yes | up to 80 characters | Question: What the viewer is asked to choose, on the cover with both options. |
clipData.first | group | yes | This: The first option, on the left or at the top. | |
clipData.first.label | text | yes | up to 32 characters | Name: What this option is, short: two or three words. |
clipData.first.picture | image | media:// file from the media library, alt text up to 120 characters | Picture: A picture of the first option. Left out, its name stands alone on its card. | |
clipData.first.detail | text | up to 60 characters | Line under it: A few words more about it, under the name. | |
clipData.first.share | number | from 0, to 100 | Share of the votes: Where a poll was taken: the percentage that chose it, drawn exactly as sent with a bar, the larger of the two lit. Left out, no share is drawn, so a question asked for the first time never shows a made-up result. | |
clipData.second | group | yes | That: The second option, on the right or at the bottom. | |
clipData.second.label | text | yes | up to 32 characters | Name: What this option is, short: two or three words. |
clipData.second.picture | image | media:// file from the media library, alt text up to 120 characters | Picture: A picture of the second option. Left out, its name stands alone on its card. | |
clipData.second.detail | text | up to 60 characters | Line under it: A few words more about it, under the name. | |
clipData.second.share | number | from 0, to 100 | Share of the votes: Where a poll was taken: the percentage that chose it, drawn exactly as sent with a bar, the larger of the two lit. Left out, no share is drawn, so a question asked for the first time never shows a made-up result. | |
clipData.pictureFit | enum | auto, fill, whole | Picture fit: Automatic, the default, fills the frame when a picture is close to its shape and shows it whole when filling would cut off more than a sixth of it, so no picture is cropped away. Fill the frame always crops to the frame, right for photographs; Show it whole never crops, right for logos and cut-out products. | |
clipData.pictureFocus | enum | centre, top, bottom, left, right | Picture focus: Which part of a picture stays in view when it fills its frame and its edges are cropped: the middle, or one side. | |
clipData.orWord | text | up to 6 characters | Word between: The word between the two options, in the language of the clip, such as or, oder, o. Left out, a mark stands between them. | |
clipData.ask | text | up to 60 characters | Ask: The question handed to the viewer, under the options once they are there, such as Tell us in the comments. | |
clipData.source | text | up to 70 characters | Source: Where the shares come from, at the foot. Drawn exactly as written: write its label too, as the template adds no word of its own. | |
clipData.more | list | at least 0, up to 3 | More pairs: Up to three further questions, a page each with its own two options. Each adds five seconds. | |
clipData.more[] | group | Pair | ||
clipData.more[].question | text | yes | up to 80 characters | Question |
clipData.more[].first | group | yes | This | |
clipData.more[].first.label | text | yes | up to 32 characters | Name: What this option is, short: two or three words. |
clipData.more[].first.picture | image | media:// file from the media library, alt text up to 120 characters | Picture: A picture of the first option. Left out, its name stands alone on its card. | |
clipData.more[].first.detail | text | up to 60 characters | Line under it: A few words more about it, under the name. | |
clipData.more[].first.share | number | from 0, to 100 | Share of the votes: Where a poll was taken: the percentage that chose it, drawn exactly as sent with a bar, the larger of the two lit. Left out, no share is drawn, so a question asked for the first time never shows a made-up result. | |
clipData.more[].second | group | yes | That | |
clipData.more[].second.label | text | yes | up to 32 characters | Name: What this option is, short: two or three words. |
clipData.more[].second.picture | image | media:// file from the media library, alt text up to 120 characters | Picture: A picture of the second option. Left out, its name stands alone on its card. | |
clipData.more[].second.detail | text | up to 60 characters | Line under it: A few words more about it, under the name. | |
clipData.more[].second.share | number | from 0, to 100 | Share of the votes: Where a poll was taken: the percentage that chose it, drawn exactly as sent with a bar, the larger of the two lit. Left out, no share is drawn, so a question asked for the first time never shows a made-up result. | |
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; 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 | 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. | |
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.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. | |
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_f29263ec9236?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": "This or that?",
"question": "Which look would you pick for our new card?",
"first": {
"label": "Calm waves",
"picture": {
"alt": "Soft waves of violet and blue",
"url": "media://example-image.jpg"
},
"detail": "Quiet colours, easy on the eye",
"share": 42
},
"second": {
"label": "Bold ink",
"picture": {
"alt": "Swirls of blue and red ink in water",
"url": "media://example-image.png"
},
"detail": "Loud colour that stands out",
"share": 58
},
"pictureFit": "auto",
"pictureFocus": "centre",
"orWord": "or",
"ask": "Which would you pick? Tell us below",
"source": "Source: poll of 1,240 followers, March 2026",
"more": [
{
"first": {
"label": "Calm waves",
"picture": {
"alt": "Soft waves of violet and blue",
"url": "media://example-image.jpg"
}
},
"second": {
"label": "Bold ink",
"picture": {
"alt": "Swirls of blue and red ink in water",
"url": "media://example-image.png"
}
},
"question": "And for the app's home screen?"
}
],
"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",
"hideHeader": false,
"hideFooter": false,
"pattern": "auto"
}
},
"metaData": {
"title": "This or that: which look for our new card?",
"captionTiny": "This or that? 58% of you chose bold ink for our new card, 42% calm waves. Which would you carry?",
"captionShort": "This or that? We asked which look you would pick for our new card, and 1,240 of you answered: 58% chose bold ink, 42% calm waves. Did the majority get it right? Tell us which one you would carry, and which look the app's home screen should wear.",
"captionMedium": "This or that? We asked which look you would pick for our new card, and 1,240 of you answered.\n\nCalm waves, quiet violet and blue: 42%.\nBold ink, loud colour that stands out: 58%.\n\nDid the majority get it right? Tell us which one you would carry, and whether the app's home screen should match the card.",
"captionLong": "This or that? We asked which look you would pick for our new card, and 1,240 of you answered in a week.\n\nCalm waves, quiet violet and blue, easy on the eye, the kind of card you forget you are carrying until you need it: 42%.\n\nBold ink, loud colour that stands out in every wallet and at every checkout, the kind of card people ask you about: 58%.\n\nAnd a second question for you: should the app's home screen wear the same look as the card, or something of its own?\n\nTell us which one you would carry, and why. We read every answer, and we will show the winning design next month. Poll of 1,240 followers, March 2026.",
"hashtags": [
"thisorthat",
"vote",
"design",
"poll",
"yourpick"
]
}
}
}
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.