When you want to automate this

One video per product, straight from your catalog.

1
See it
OutputMP4
Size1080 × 1920 (9:16)
Length10s
Frame rate25 fps
Tracks / clips18 / 24
Assets used1 audio, 5 image, 6 luma, 5 rich-text, 7 svg
Soundtrackno
Merge fields11
2
Make it yours

Send a merge array with your values for these fields:

FieldDefault value
{{ LOGO }}https://templates.shotstack.io/festive-season-sale-promo-template-fashion-offer/ec3f1212-2892-44dc-bdad-1441495bae06/source.png
{{ WHITE_COLOR }}#ffffff
{{ IMAGE_SRC }}https://templates.shotstack.io/festive-season-sale-promo-template-fashion-offer/b6f55737-4a47-4d1f-9a3d-5d79fca4844b/source.jpg
{{ RED_COLOR }}#b81414
{{ PROMO }}40% OFF
{{ TITLE }}Special Sale
{{ PINK_COLOR }}#f36d9c
{{ DESCRIPTION }}Looking for great deals on quality products? Check out our special sale products!
{{ CTA }}SHOP NOW
{{ BLACK_COLOR }}#000000
{{ AUDIO_SRC }}https://templates.shotstack.io/festive-season-sale-promo-template-fashion-offer/c536bb55-9194-43aa-a5d9-da87b5a3b4f7/source.mp3
Edit and save to your account
3
Run it once

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 --watch

Sandbox renders are free and watermarked. Production: the v1 endpoint and key. SDKs

4
Automate it

Loop over your product feed and render a promo per SKU — prices and images always current.

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 11 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

Common questions

How do I change the text and media without editing the JSON?

Use the 11 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.

Is this template made for TikTok, Reels and Shorts?

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.

Can I use my own photos?

Yes. The template uses 5 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.

How do I change the text and fonts?

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.