{
"timeline": {
"fonts": [
{
"src": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-p85d2-d0chw-7f9tr-88wzt0/source.ttf"
}
],
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO_SRC }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "{{Title}}",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "{{ FONT_COLOR }}",
"family": "EB Garamond",
"size": "38",
"lineHeight": 1
},
"width": 400,
"height": 72
},
"start": 1.8,
"length": "end",
"offset": {
"x": 0,
"y": 0.026
},
"position": "center",
"transition": {
"in": "slideUp"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Flower }}"
},
"start": 2,
"scale": 0.04,
"offset": {
"x": 0,
"y": -0.053
},
"position": "center",
"transition": {
"in": "slideUp"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_6 }}"
},
"start": 0.8,
"scale": 0.26,
"offset": {
"x": -0.136,
"y": -0.324
},
"position": "center",
"transition": {
"in": "carouselLeft"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_3 }}"
},
"start": 0.2,
"scale": 0.26,
"offset": {
"x": 0.138,
"y": 0.325
},
"position": "center",
"transition": {
"in": "carouselRight"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_7 }}"
},
"start": 1,
"scale": 0.32,
"offset": {
"x": 0.248,
"y": -0.325
},
"position": "center",
"transition": {
"in": "carouselLeft"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_4 }}"
},
"start": 0.4,
"scale": 0.32,
"offset": {
"x": -0.245,
"y": 0.324
},
"position": "center",
"transition": {
"in": "carouselRight"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_8 }}"
},
"start": 1.2,
"scale": 0.215,
"offset": {
"x": 0.382,
"y": 0.17
},
"position": "center",
"transition": {
"in": "carouselDown"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_5 }}"
},
"start": 0.6,
"scale": 0.215,
"offset": {
"x": -0.383,
"y": -0.165
},
"position": "center",
"transition": {
"in": "carouselUp"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_1 }}"
},
"start": 0,
"scale": 0.135,
"offset": {
"x": 0.195,
"y": 0
},
"position": "center",
"transition": {
"in": "carouselDown"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_2 }}"
},
"start": 1.4,
"scale": 0.135,
"offset": {
"x": -0.198,
"y": 0
},
"position": "center",
"transition": {
"in": "slideRight"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat ExtraBold",
"size": 46,
"lineHeight": 1
},
"width": 462,
"height": 324,
"background": {
"color": "{{ SHAPE_COLOR }}"
}
},
"start": 1.6,
"length": "end",
"transition": {
"in": "fade"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat ExtraBold",
"size": 46,
"lineHeight": 1
},
"width": 1920,
"height": 1080,
"background": {
"color": "{{ BACKGROUND_COLOR }}"
}
},
"start": 0,
"length": 5
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1920,
"height": 1080
}
},
"merge": [
{
"find": "Title",
"replace": "COMPLIMENTS OF THE SEASON"
},
{
"find": "Flower",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-nxzvp-smygc-mmbs2-xma6k3/source.png"
},
{
"find": "IMAGE_1",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-ksfwm-8vngw-jf01h-5844nm/source.png"
},
{
"find": "IMAGE_2",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-krftt-btr2b-s32kk-4qjb1n/source.png"
},
{
"find": "IMAGE_3",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-nd1g2-eq6xx-9jvhf-dp69av/source.png"
},
{
"find": "IMAGE_4",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-mza3a-qe6c2-23s51-wt74e1/source.png"
},
{
"find": "IMAGE_5",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-m4gds-m97p8-b61jx-x86fvd/source.png"
},
{
"find": "IMAGE_6",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-nfnb6-qcz17-4q4hb-5f718s/source.png"
},
{
"find": "IMAGE_7",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-n6n5x-gb58a-3t8wz-mh7sc1/source.png"
},
{
"find": "IMAGE_8",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-m91cs-ftqv3-5zvx4-y0ydhp/source.png"
},
{
"find": "FONT_COLOR",
"replace": "#000000"
},
{
"find": "SHAPE_COLOR",
"replace": "#d8d8d8"
},
{
"find": "AUDIO_SRC",
"replace": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-qqm78-bz254-9y9eg-6adhys/source.mp3"
},
{
"find": "BACKGROUND_COLOR",
"replace": "#ffffff"
}
]
}Embrace the magic of the winter holidays with our "Festive Season's Greetings" promotional template. Designed for businesses ready to launch their seasonal marketing campaigns, this template provides a stunning visual backdrop to showcase your special offers, holiday sales, and exclusive events. Featuring a charming, winter-themed collage, this template is fully customizable and user-friendly. You can effortlessly update the text to announce your specific promotions, whether it's a percentage discount, a special event, or a limited-time offer. Its clean and engaging design is optimized to capture customer attention and drive engagement, helping you boost sales and spread holiday cheer. Get ready to connect with your audience and make this season your most successful one yet!
No account needed until you render.
Render with your AI assistant
Add the Shotstack MCP server to your editor, then paste the prompt
| Output | MP4 |
|---|---|
| Size | 1920 × 1080 (16:9) |
| Length | 5s |
| Frame rate | 25 fps |
| Tracks / clips | 13 / 13 |
| Assets used | 1 audio, 9 image, 3 text |
| Soundtrack | no |
| Merge fields | 14 |
Send a merge array with your values for these fields:
| Field | Default value |
|---|---|
{{ Title }} | COMPLIMENTS OF THE SEASON |
{{ Flower }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-nxzvp-smygc-mmbs2-xma6k3/source.png |
{{ IMAGE_1 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-ksfwm-8vngw-jf01h-5844nm/source.png |
{{ IMAGE_2 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-krftt-btr2b-s32kk-4qjb1n/source.png |
{{ IMAGE_3 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-nd1g2-eq6xx-9jvhf-dp69av/source.png |
{{ IMAGE_4 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-mza3a-qe6c2-23s51-wt74e1/source.png |
{{ IMAGE_5 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-m4gds-m97p8-b61jx-x86fvd/source.png |
{{ IMAGE_6 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-nfnb6-qcz17-4q4hb-5f718s/source.png |
{{ IMAGE_7 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-n6n5x-gb58a-3t8wz-mh7sc1/source.png |
{{ IMAGE_8 }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-m91cs-ftqv3-5zvx4-y0ydhp/source.png |
{{ FONT_COLOR }} | #000000 |
{{ SHAPE_COLOR }} | #d8d8d8 |
{{ AUDIO_SRC }} | https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01k31-qqm78-bz254-9y9eg-6adhys/source.mp3 |
{{ BACKGROUND_COLOR }} | #ffffff |
Save the JSON above as template.json, then render in the free sandbox:
# Save the JSON above as template.json, then:
curl -X POST https://api.shotstack.io/edit/stage/render \
-H "x-api-key: $SHOTSTACK_API_KEY" \
-H "Content-Type: application/json" \
-d @template.json
# Poll until status is "done", then download response.url
curl https://api.shotstack.io/edit/stage/render/RENDER_ID -H "x-api-key: $SHOTSTACK_API_KEY"import { readFileSync } from 'node:fs';
const headers = { 'x-api-key': process.env.SHOTSTACK_API_KEY, 'Content-Type': 'application/json' };
const edit = JSON.parse(readFileSync('template.json', 'utf8'));
const { response } = await fetch('https://api.shotstack.io/edit/stage/render', {
method: 'POST', headers, body: JSON.stringify(edit)
}).then((r) => r.json());
let render;
do {
await new Promise((r) => setTimeout(r, 3000));
render = (await fetch(`https://api.shotstack.io/edit/stage/render/${response.id}`, { headers }).then((r) => r.json())).response;
} while (!['done', 'failed'].includes(render.status));
console.log(render.status, render.url);import json, os, time, requests
headers = {"x-api-key": os.environ["SHOTSTACK_API_KEY"]}
with open("template.json") as f:
edit = json.load(f)
render_id = requests.post("https://api.shotstack.io/edit/stage/render", json=edit, headers=headers).json()["response"]["id"]
while True:
render = requests.get(f"https://api.shotstack.io/edit/stage/render/{render_id}", headers=headers).json()["response"]
if render["status"] in ("done", "failed"):
break
time.sleep(3)
print(render["status"], render.get("url"))npm install -g @shotstack/cli
export SHOTSTACK_API_KEY=your_sandbox_key
shotstack validate template.json # offline schema check, free
shotstack render template.json --env stage --watchSandbox renders are free and watermarked. Production: the v1 endpoint and key. SDKs
Merge each recipient’s name and details to send everyone their own version.
Paste into Claude, ChatGPT or Cursor — your AI assistant builds the workflow around your data.
Node.js, one render per CSV row, wired to this template's 14 merge fields. Setup steps in the header.
Guides: Bulk-create from a CSV · Webhooks · Templates endpoint · Render your first video
AI assistants: Markdown () · · · CLI skill: SKILL.md () · MCP server
Use the 14 merge fields listed above. Send a merge array with your own values for each field and the API swaps them in at render time, so one template can produce thousands of unique videos.
Yes. This template renders 1920×1080 by default. Set output.resolution to "1080" or output.size to a larger 16:9 size in the JSON; the layout scales with it.
Yes. The template uses 9 images; replace each image asset's src with a public URL of your own file (JPG, PNG or WebP). Keep the timing and effects, or adjust them per clip.
Edit the text on each text asset in the JSON. Fonts come from the timeline fonts list or the asset's font family; add your own font file URL to timeline.fonts to use a brand typeface.
