{
"timeline": {
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Title}}",
"font": {
"family": "Montserrat ExtraBold",
"size": 100,
"weight": 800,
"color": "#ffffff",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "slideIn",
"direction": "down",
"style": "word"
}
},
"start": 0.2,
"length": "end",
"offset": {
"x": 0,
"y": 0.243
},
"position": "center",
"transition": {
"in": "slideUp"
},
"width": 800,
"height": 300
}
]
},
{
"clips": [
{
"length": 8,
"fit": "crop",
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/holiday-recap-video-story-promo-template/mefmfnxkhvssy65bte2ythym/source_cac46d11.webm"
},
"start": 0,
"width": 1085,
"height": 1920,
"offset": {
"x": 0,
"y": 0
}
},
{
"length": 2.1999999999999993,
"fit": "crop",
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/holiday-recap-video-story-promo-template/mefmfnxkhvssy65bte2ythym/source_cac46d11.webm"
},
"start": 8,
"width": 1085,
"height": 1920,
"offset": {
"x": 0,
"y": 0
}
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_2 }}",
"volume": 1
},
"start": 0,
"scale": 1,
"offset": {
"x": 0,
"y": -0.2642027290448343
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 1135,
"height": 568
}
]
},
{
"clips": [
{
"length": 10,
"asset": {
"type": "video",
"src": "{{ VIDEO_3 }}",
"volume": 1
},
"start": 0.2,
"scale": 1,
"offset": {
"x": 0.003981481481481475,
"y": 0.2499167994430422
},
"position": "center",
"transition": {
"in": "slideRight"
},
"fit": "contain",
"width": 1135,
"height": 568
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_1 }}",
"volume": 1
},
"start": 0.5,
"scale": 1,
"offset": {
"x": 0,
"y": -0.0053963811030397464
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"fit": "contain",
"width": 1135,
"height": 568
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1080,
"height": 1920
},
"destinations": [
{
"provider": "shotstack"
}
]
},
"merge": [
{
"find": "VIDEO_1",
"replace": "https://templates.shotstack.io/holiday-recap-video-story-promo-template/4245fdfe-7240-463d-b9df-5e7860cf54bc/source.mp4"
},
{
"find": "VIDEO_2",
"replace": "https://templates.shotstack.io/holiday-recap-video-story-promo-template/35724443-8285-405b-892a-f16a3329e9a8/source.mp4"
},
{
"find": "VIDEO_3",
"replace": "https://templates.shotstack.io/holiday-recap-video-story-promo-template/e6cc8fc3-f673-4d7f-af62-93e07f346cc0/source.mp4"
},
{
"find": "Title",
"replace": "HOLIDAY RECAP"
},
{
"find": "AUDIO",
"replace": "https://templates.shotstack.io/holiday-recap-video-story-promo-template/3865ef2d-7057-49fd-bfdb-06a13a0a87f0/source.mp3"
}
]
}Capture the vibrant, carefree energy of a great holiday and channel it into your marketing. Our Holiday Adventure Recap Story Template lets you showcase your promotions through the lens of an exciting travel vlog or a cherished memory reel. The authentic camcorder interface gives your content a raw, personal feel that cuts through the noise and connects with viewers instantly. This template is designed for storytelling. Use it to create a fast-paced recap of your biggest holiday sale, announce a special seasonal offer, or feature your products in a real-world, adventurous setting. It’s perfect for brands that want to evoke feelings of freedom, joy, and discovery. Effortlessly easy to use, you can drop in your video clips and customize the text to create a professional-looking promo in minutes. Stop just announcing sales, start sharing experiences. This template helps you build a genuine connection that turns followers into loyal customers.
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 | 10.2s |
| Frame rate | 25 fps |
| Tracks / clips | 6 / 7 |
| Assets used | 1 audio, 1 rich-text, 5 video |
| Soundtrack | no |
| Merge fields | 5 |
Send a merge array with your values for these fields:
| Field | Default value |
|---|---|
{{ VIDEO_1 }} | https://templates.shotstack.io/holiday-recap-video-story-promo-template/4245fdfe-7240-463d-b9df-5e7860cf54bc/source.mp4 |
{{ VIDEO_2 }} | https://templates.shotstack.io/holiday-recap-video-story-promo-template/35724443-8285-405b-892a-f16a3329e9a8/source.mp4 |
{{ VIDEO_3 }} | https://templates.shotstack.io/holiday-recap-video-story-promo-template/e6cc8fc3-f673-4d7f-af62-93e07f346cc0/source.mp4 |
{{ Title }} | HOLIDAY RECAP |
{{ AUDIO }} | https://templates.shotstack.io/holiday-recap-video-story-promo-template/3865ef2d-7057-49fd-bfdb-06a13a0a87f0/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
Loop over your content calendar and keep the feed full without an editor.
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 5 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 5 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. 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 rich-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.
