{
"timeline": {
"fonts": [
{
"src": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/9e72b4f4-4f46-4d0d-aac9-02c687ab3722/source.otf"
}
],
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/2f8efbde-75c8-4167-9dd3-8d7c19106835/source.png"
},
"start": 0,
"length": "end"
},
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "HolidayFree",
"size": "32",
"lineHeight": 1
},
"width": 500,
"height": 500,
"background": {
"color": "{{ TEXT_BACKGROUND_COLOR }}"
}
},
"start": 0.2,
"length": "end",
"offset": {
"x": 0.38,
"y": 0.426
},
"position": "center",
"transition": {
"in": "slideDown"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "HolidayFree",
"size": "32",
"lineHeight": 1
},
"width": 500,
"height": 500,
"background": {
"color": "{{ TEXT_BACKGROUND_COLOR }}"
}
},
"start": 0,
"length": "end",
"offset": {
"x": -0.382,
"y": 0.416
},
"position": "center",
"transition": {
"in": "slideDown"
}
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/a7f108a8-0ea3-42d7-a9d6-a2719d361871/source.png"
},
"start": 0,
"length": "end"
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "{{Title}}",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "{{ FONT_COLOR }}",
"family": "HolidayFree",
"size": "65",
"lineHeight": 1
},
"width": 800,
"height": 150
},
"start": 1.2,
"length": "end",
"offset": {
"x": 0,
"y": 0.012
},
"position": "center",
"transition": {
"in": "fade"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/da65a9c4-e28b-402d-92cb-4285d372e0d8/source.png"
},
"start": 0,
"length": 10
},
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat SemiBold",
"size": 24,
"lineHeight": 1
},
"width": 800,
"height": 800,
"background": {
"color": "{{ SHAPE_BACKGROUND_COLOR }}"
}
},
"start": 1,
"length": "end",
"offset": {
"x": -0.007,
"y": -0.009
},
"position": "center",
"transition": {
"in": "fade"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_4 }}",
"volume": 1
},
"start": 0.8,
"scale": 0.37,
"offset": {
"x": 0.2,
"y": -0.173
},
"position": "center",
"transform": {
"rotate": {
"angle": -2.5
}
},
"transition": {
"in": "carouselLeft"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat SemiBold",
"size": 24,
"lineHeight": 1
},
"width": 750,
"height": 424,
"background": {
"color": "{{ FONT_COLOR }}"
}
},
"start": 0.8,
"length": "end",
"transform": {
"rotate": {
"angle": -2.5
}
},
"offset": {
"x": 0.2,
"y": -0.173
},
"position": "center",
"transition": {
"in": "carouselLeft"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_2 }}",
"volume": 1
},
"start": 0.4,
"scale": 0.37,
"offset": {
"x": 0.195,
"y": 0.208
},
"position": "center",
"transform": {
"rotate": {
"angle": 4
}
},
"transition": {
"in": "carouselLeft"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat SemiBold",
"size": 24,
"lineHeight": 1
},
"width": 750,
"height": 424,
"background": {
"color": "{{ FONT_COLOR }}"
}
},
"start": 0.4,
"length": "end",
"transform": {
"rotate": {
"angle": 4
}
},
"offset": {
"x": 0.195,
"y": 0.208
},
"position": "center",
"transition": {
"in": "carouselLeft"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_3 }}",
"volume": 1
},
"start": 0.6,
"scale": 0.37,
"offset": {
"x": -0.197,
"y": -0.173
},
"position": "center",
"transform": {
"rotate": {
"angle": 2.9
}
},
"transition": {
"in": "carouselRight"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat SemiBold",
"size": 24,
"lineHeight": 1
},
"width": 750,
"height": 424,
"background": {
"color": "{{ FONT_COLOR }}"
}
},
"start": 0.6,
"length": "end",
"transform": {
"rotate": {
"angle": 2.9
}
},
"offset": {
"x": -0.197,
"y": -0.173
},
"position": "center",
"transition": {
"in": "carouselRight"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_1 }}",
"volume": 1
},
"start": 0.2,
"scale": 0.37,
"offset": {
"x": -0.192,
"y": 0.218
},
"position": "center",
"transform": {
"rotate": {
"angle": -2.5
}
},
"transition": {
"in": "carouselRight"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat SemiBold",
"size": 24,
"lineHeight": 1
},
"width": 750,
"height": 424,
"background": {
"color": "{{ FONT_COLOR }}"
}
},
"start": 0.2,
"length": "end",
"transform": {
"rotate": {
"angle": -2.5
}
},
"offset": {
"x": -0.189,
"y": 0.22
},
"position": "center",
"transition": {
"in": "carouselRight"
}
}
]
},
{
"clips": [
{
"length": 10,
"asset": {
"type": "image",
"src": "{{ BACKGROUND_IMAGE }}"
},
"start": 0
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1920,
"height": 1080
}
},
"merge": [
{
"find": "Title",
"replace": "Season Greetings"
},
{
"find": "FONT_COLOR",
"replace": "#ffffff"
},
{
"find": "SHAPE_BACKGROUND_COLOR",
"replace": "#167a37"
},
{
"find": "BACKGROUND_IMAGE",
"replace": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/12dc7b16-2a3f-4d60-b8ae-7d9e348e33f4/source.jpg"
},
{
"find": "VIDEO_1",
"replace": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/d16be338-0192-4b88-aecb-dafc6b356724/source.mp4"
},
{
"find": "VIDEO_2",
"replace": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/7da7e4c9-2bc5-49cd-a10b-7fdddaeedcd5/source.mp4"
},
{
"find": "VIDEO_3",
"replace": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/4ded2e54-604a-46a4-8f68-b8239ebb248f/source.mp4"
},
{
"find": "VIDEO_4",
"replace": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/0727bc17-4687-4f7a-834b-db27716534a1/source.mp4"
},
{
"find": "TEXT_BACKGROUND_COLOR",
"replace": "#ddbc00"
},
{
"find": "AUDIO",
"replace": "https://templates.shotstack.io/joyful-christmas-photo-collage-template/7211278b-2350-495c-9e3c-79ac22b2f525/source.mp3"
}
]
}Share the warmth and joy of the holiday season with our "Season's Greetings" photo collage template. This beautifully arranged design captures the essence of Christmas through a collection of festive images, perfect for sending heartfelt wishes to loved ones, customers, or your social media audience. The template features four distinct moments: a joyful gathering of friends in Santa hats, a child delighting in a new gift, a cosy family scene by the Christmas tree, and the tradition of wrapping presents. The central "Season Greetings" message ties it all together against a backdrop of twinkling lights and holiday cheer. This easy-to-customise template is ideal for creating personalised e-cards, social media posts, or printed greetings that spread happiness and celebrate connection during the most wonderful time of the year.
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 | 10s |
| Frame rate | 25 fps |
| Tracks / clips | 14 / 17 |
| Assets used | 1 audio, 1 image, 3 luma, 8 text, 4 video |
| Soundtrack | no |
| Merge fields | 10 |
Send a merge array with your values for these fields:
| Field | Default value |
|---|---|
{{ Title }} | Season Greetings |
{{ FONT_COLOR }} | #ffffff |
{{ SHAPE_BACKGROUND_COLOR }} | #167a37 |
{{ BACKGROUND_IMAGE }} | https://templates.shotstack.io/joyful-christmas-photo-collage-template/12dc7b16-2a3f-4d60-b8ae-7d9e348e33f4/source.jpg |
{{ VIDEO_1 }} | https://templates.shotstack.io/joyful-christmas-photo-collage-template/d16be338-0192-4b88-aecb-dafc6b356724/source.mp4 |
{{ VIDEO_2 }} | https://templates.shotstack.io/joyful-christmas-photo-collage-template/7da7e4c9-2bc5-49cd-a10b-7fdddaeedcd5/source.mp4 |
{{ VIDEO_3 }} | https://templates.shotstack.io/joyful-christmas-photo-collage-template/4ded2e54-604a-46a4-8f68-b8239ebb248f/source.mp4 |
{{ VIDEO_4 }} | https://templates.shotstack.io/joyful-christmas-photo-collage-template/0727bc17-4687-4f7a-834b-db27716534a1/source.mp4 |
{{ TEXT_BACKGROUND_COLOR }} | #ddbc00 |
{{ AUDIO }} | https://templates.shotstack.io/joyful-christmas-photo-collage-template/7211278b-2350-495c-9e3c-79ac22b2f525/source.mp3 |
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
Send a new set of image URLs per request and every batch becomes its own slideshow.
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 10 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 10 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. Replace the video asset's src with a public URL of your file (MP4 works best). Use trim and length on the clip to pick the part you want, and the template's effects apply to your footage.
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.
