{
"timeline": {
"fonts": [
{
"src": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/50517c89-faa9-4c7c-bb24-314d94e9d41a/source.ttf"
},
{
"src": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/1df69277-3ada-4927-a00c-16fbf09f24dd/source.otf"
}
],
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "{{Title}}",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "{{ FONT_COLOR }}",
"family": "Noto Serif Display",
"size": "150",
"lineHeight": 1
},
"width": 800,
"height": 380
},
"start": 0.6,
"length": "end",
"offset": {
"x": 0,
"y": 0.352
},
"position": "center",
"transition": {
"in": "slideUp"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "{{Body}}",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "{{ FONT_COLOR }}",
"family": "Gotham Book",
"size": "40",
"lineHeight": 1
},
"width": 700,
"height": 250
},
"start": 1,
"length": "end",
"offset": {
"x": 0,
"y": -0.314
},
"position": "center",
"transition": {
"in": "slideUp"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Tree }}"
},
"start": 0.9,
"scale": 0.35,
"offset": {
"x": 0.5,
"y": -0.35
},
"position": "center",
"transition": {
"in": "slideLeft"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Tree }}"
},
"start": 0.8,
"scale": 0.35,
"offset": {
"x": -0.551,
"y": -0.35
},
"position": "center",
"transition": {
"in": "slideRight"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Light_1 }}"
},
"start": 0.2,
"scale": 0.15,
"offset": {
"x": -0.254,
"y": 0.43
},
"position": "center",
"opacity": 1,
"transition": {
"in": "slideDown"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Light_2 }}"
},
"start": 0.2,
"scale": 0.15,
"offset": {
"x": 0.282,
"y": 0.43
},
"position": "center",
"transition": {
"in": "slideDown"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Ball_2 }}"
},
"start": 0.4,
"scale": 0.25,
"offset": {
"x": 0.444,
"y": 0.385
},
"position": "center",
"transition": {
"in": "slideLeft"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Ball_1 }}"
},
"start": 0.4,
"scale": 0.25,
"offset": {
"x": -0.442,
"y": 0.38
},
"position": "center",
"transition": {
"in": "slideRight"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/bf4f96ae-0c63-4d2b-bcda-23db2c15b1a3/source.png"
},
"start": 0,
"length": 8
},
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_1 }}"
},
"start": 0.5,
"scale": 0.45,
"offset": {
"x": 0,
"y": 0.024
},
"position": "center",
"transition": {
"in": "slideUp"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ BACKGROUND_SNOW }}"
},
"start": 0.4,
"scale": 0.55,
"offset": {
"x": -0.022,
"y": 0.216
},
"position": "center",
"transform": {
"rotate": {
"angle": 90
}
},
"opacity": 0.6,
"transition": {
"in": "fadeSlow"
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ BACKGROUND_SNOW }}"
},
"start": 0.5,
"scale": 0.6,
"offset": {
"x": -0.022,
"y": -0.265
},
"position": "center",
"transform": {
"rotate": {
"angle": 90
}
},
"opacity": 0.67,
"transition": {
"in": "fade"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat SemiBold",
"size": 24,
"lineHeight": 1
},
"width": 1080,
"height": 1920,
"background": {
"color": "{{ BACKGROUND_COLOR }}"
}
},
"start": 0,
"length": 8,
"position": "center"
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1080,
"height": 1920
}
},
"merge": [
{
"find": "Title",
"replace": "Season's Greetings"
},
{
"find": "Body",
"replace": "Sending heartfelt wishes for a season of harmony, laughter, and treasured moments surrounded by those you hold dear."
},
{
"find": "IMAGE_1",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/8287e046-841b-4ce0-b534-144863f7f663/source.png"
},
{
"find": "Light_1",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/ba94ca67-bab9-439e-85db-bcf304217d30/source.png"
},
{
"find": "Light_2",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/1de08935-ec26-435d-bd0d-104e85df9f3e/source.png"
},
{
"find": "Ball_1",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/ae98c809-2ed3-4941-924c-b4d8cfba79eb/source.png"
},
{
"find": "Ball_2",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/bd02f7dd-44b3-4ae4-bd28-1c4ecd92494f/source.png"
},
{
"find": "Tree",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/c9178293-e291-456f-845e-93872b942792/source.png"
},
{
"find": "BACKGROUND_SNOW",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/0d3512c6-44d5-421b-b8d0-c21ba7158953/source.png"
},
{
"find": "FONT_COLOR",
"replace": "#f1f0e2"
},
{
"find": "BACKGROUND_COLOR",
"replace": "#0c4a09"
},
{
"find": "AUDIO",
"replace": "https://templates.shotstack.io/festive-family-seasons-greetings-card-template/1aee82d1-ab85-4345-976a-b48a7ac248d6/source.mp3"
}
]
}Capture the spirit of the season and connect with your customers using our "Festive Family Season's Greetings" template. Designed for businesses of all sizes, this template provides a heartfelt way to announce your holiday sales, special events, or exclusive end-of-year offers. The design features a warm, inviting space for a central image, surrounded by classic holiday decorations, making it highly customizable for your brand's message. It’s incredibly user-friendly, allowing you to effortlessly update the text to reflect your specific promotion. Use this template to send heartfelt wishes and drive engagement, turning festive cheer into measurable business growth 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 | 1080 × 1920 (9:16) |
| Length | 8s |
| Frame rate | 25 fps |
| Tracks / clips | 13 / 14 |
| Assets used | 1 audio, 9 image, 1 luma, 3 text |
| Soundtrack | no |
| Merge fields | 12 |
Send a merge array with your values for these fields:
| Field | Default value |
|---|---|
{{ Title }} | Season's Greetings |
{{ Body }} | Sending heartfelt wishes for a season of harmony, laughter, and treasured moments surrounded by those you hold dear. |
{{ IMAGE_1 }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/8287e046-841b-4ce0-b534-144863f7f663/source.png |
{{ Light_1 }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/ba94ca67-bab9-439e-85db-bcf304217d30/source.png |
{{ Light_2 }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/1de08935-ec26-435d-bd0d-104e85df9f3e/source.png |
{{ Ball_1 }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/ae98c809-2ed3-4941-924c-b4d8cfba79eb/source.png |
{{ Ball_2 }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/bd02f7dd-44b3-4ae4-bd28-1c4ecd92494f/source.png |
{{ Tree }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/c9178293-e291-456f-845e-93872b942792/source.png |
{{ BACKGROUND_SNOW }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/0d3512c6-44d5-421b-b8d0-c21ba7158953/source.png |
{{ FONT_COLOR }} | #f1f0e2 |
{{ BACKGROUND_COLOR }} | #0c4a09 |
{{ AUDIO }} | https://templates.shotstack.io/festive-family-seasons-greetings-card-template/1aee82d1-ab85-4345-976a-b48a7ac248d6/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
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 12 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 12 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. It renders vertical 1080×1920 (9:16), the format those platforms expect. Change output.size or output.aspectRatio in the JSON if you also need a square or landscape cut.
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.