# Holiday Recap Promotional Story Template (video template)

> Announce your next big offer with our vibrant Holiday Recap template, perfect for creating buzz around seasonal sales and promotions.

## Overview

- **Page**: https://shotstack.io/studio/templates/holiday-recap-promo-story-template-sale/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 15s
- **Timeline**: 26 clips on 19 tracks; assets: audio, image, luma, text, video
- **Render endpoint (sandbox, free, watermarked)**: POST https://api.shotstack.io/edit/stage/render with header `x-api-key`
- **Production**: same request against https://api.shotstack.io/edit/v1/render with a v1 key
- **Preview in the browser (no account)**: https://shotstack.studio/#json=eyJ0aW1lbGluZSI6eyJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV84IH19In0sInN0YXJ0IjoxNH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzcgfX0ifSwic3RhcnQiOjEzfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfNiB9fSJ9LCJzdGFydCI6MTJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV81IH19In0sInN0YXJ0IjoxMX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzQgfX0ifSwic3RhcnQiOjEwfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfMyB9fSJ9LCJzdGFydCI6OX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzIgfX0ifSwic3RhcnQiOjh9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV8xIH19In0sInN0YXJ0Ijo3fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UzFfVGl0bGV9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiNmZmZmZmYiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOiIxMDAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjUwMCwiaGVpZ2h0IjoyNTB9LCJzdGFydCI6MC41LCJsZW5ndGgiOjYuNSwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXBTbG93In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLjUsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzEgfX0ifSwic3RhcnQiOjUsInNjYWxlIjowLjQsIm9mZnNldCI6eyJ4IjowLjA1NywieSI6MH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUiLCJvdXQiOiJmYWRlIn19LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2NhNDg4YWJiLTg4NDUtNGUwOC1iZmEyLTM0NGMzMjk2OTk0OC9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJsZW5ndGgiOjd9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoyLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV8yIH19In0sInN0YXJ0Ijo0LjUsInNjYWxlIjowLjI1LCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMDYzfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUiLCJpbiI6ImZhZGUifX0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvYWE0MThjMGQtYWE1NC00YzBlLWIzMDMtMDJlMjVmYzAyNTNjL3NvdXJjZS5wbmcifSwic3RhcnQiOjAsImxlbmd0aCI6N31dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjIuNSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfMyB9fSJ9LCJzdGFydCI6NCwic2NhbGUiOjAuNCwib2Zmc2V0Ijp7IngiOi0wLjI1LCJ5IjowLjExOH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUiLCJvdXQiOiJmYWRlIn19LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzUzMmRhNjNkLWY4OTEtNGNkNS04MGIwLTVjYzUwNTEzYzBiYS9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJsZW5ndGgiOjd9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV80IH19In0sInN0YXJ0IjozLjUsInNjYWxlIjowLjQsIm9mZnNldCI6eyJ4IjowLjI0NSwieSI6MC4wOTF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0IjoiZmFkZSIsImluIjoiZmFkZSJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS81NGU3MTE2MS03YzU4LTQxNTgtODZhZS1lYTE4NWQ5NTQyNTUvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwibGVuZ3RoIjo3fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6My41LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV81IH19In0sInN0YXJ0IjozLCJzY2FsZSI6MC40LCJvZmZzZXQiOnsieCI6LTAuMjExLCJ5IjotMC4xNzZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIiwib3V0IjoiZmFkZSJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS9kYWZjMGIwOC1jZDA0LTQ1NTAtODQ2MC04M2Q5YTc3MDZhYTMvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwibGVuZ3RoIjo3fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NCwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfNiB9fSJ9LCJzdGFydCI6Mi41LCJzY2FsZSI6MC4yNSwib2Zmc2V0Ijp7IngiOjAuMDg1LCJ5IjotMC4yODV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0IjoiZmFkZSIsImluIjoiZmFkZSJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS8xMGY4MzcxZi1kMDEyLTRmM2YtODFlMS03ZTE3MmU2MTgwZjcvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwibGVuZ3RoIjo3fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NC41LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV83IH19In0sInN0YXJ0IjoyLCJzY2FsZSI6MC4yNSwib2Zmc2V0Ijp7IngiOi0wLjAyOSwieSI6MC4yNzh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIiwib3V0IjoiZmFkZSJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS8wNzZjNjMwYi0wNzI1LTQ1ZjgtOGQ5OC05ZjFlMGMxYzhiMTAvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwibGVuZ3RoIjo3fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NywiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzFfQkFDS0dST1VORF9WSURFTyB9fSJ9LCJzdGFydCI6MCwidHJhbnNpdGlvbiI6eyJvdXQiOiJmYWRlIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6NDYsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoiIzAwMDAwMCJ9fSwic3RhcnQiOjAsImxlbmd0aCI6MTV9XX1dfSwib3V0cHV0Ijp7ImZvcm1hdCI6Im1wNCIsImZwcyI6MjUsInNpemUiOnsid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH19LCJtZXJnZSI6W3siZmluZCI6IlMxX1RpdGxlIiwicmVwbGFjZSI6IkhvbGlkYXkgUmVjYXAifSx7ImZpbmQiOiJTMV9JTUFHRV8xIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvN2U2MzhhNzktMGRlOS00OGJjLWI2OWEtNmZiMTgxOGJlMDk5L3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV8yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvODFiNjNhN2QtZmQyYi00MzRmLWE5YzItZjBiNmQ3ODZiZTRhL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV8zIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvZDE1MTc3ODgtMzJhNi00OWU1LTlmNTctZjIyZTE3NGY5NDFiL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV80IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvZGRhZGZhMmItNmVmNi00NWZhLTgyMGItZGNhNDU1NTJlM2Y5L3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV81IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvMTJkMWYyYjctMTBlYS00YTM3LTk3YzUtOWIzNGJjZmFlOTcwL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV82IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvZWJlMTQwMjgtODNjNi00NjJhLTkzNjMtYzljYmY2OGZmZDIzL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV83IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvZDNkMjBlODQtMjA2Yy00YWQ4LTkxY2EtYjVhZjUyNWI1NGUyL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9CQUNLR1JPVU5EX1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvMmU1ZTQ5ZjMtYzYyNi00NWJlLTg5NzYtM2Y0OTQzNWY4N2Y5L3NvdXJjZS5tcDQifSx7ImZpbmQiOiJJTUFHRV8xIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvZDg5YjZlMmEtYjMzYy00YzdkLWFmNWMtMzNkMDM4MDFlZDBhL3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV8yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvODdmYjBiZGQtOGE0Mi00ODI1LWI5MzktOGE0YzZlNmM3ZDg4L3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV8zIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvMzFhMDYxZDUtMDI2Ny00ZGJlLThmNmUtNTZiNGExNTMxYTUyL3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV80IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvZjUzZjZjMWEtNjg5NC00OTYwLTk0M2QtZWJjNjcxNjE1ODZmL3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV81IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvMThkYzRmYjItNWE4Mi00YWY4LTlkNGUtNThkZDU5MDdiZDQ4L3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV82IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvOGY1NGJlMWYtMWViYS00ZTcwLTllYjgtYjQwZTkyZmM3NTc5L3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV83IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvNzljNTMxYjctYWE1Yy00OTcwLTkyNTctYjk1NGYzZDdlZTFlL3NvdXJjZS5qcGcifSx7ImZpbmQiOiJJTUFHRV84IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9ob2xpZGF5LXJlY2FwLXByb21vLXN0b3J5LXRlbXBsYXRlLXNhbGUvY2Q1ZjU5MGYtNjVhOS00N2NlLThhYmMtNzg3NmY1ZTg3ZWEwL3NvdXJjZS5qcGcifSx7ImZpbmQiOiJBVURJTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzkyYzExNWM0LTY4NGItNDFjZS05Y2RiLTJhYzZjNDg1MzQzYS9zb3VyY2UubXAzIn1dfQ
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/holiday-recap-promo-story-template-sale

## How to use this template as a workflow

1. Render it once with the JSON below to confirm the output.
2. Replace the values that change per row of data (merge fields or asset URLs).
3. Loop over your data (CSV, database, webhook payload) and send one render per row. Add a `callback` URL to the request so Shotstack notifies you when each video is ready instead of polling.
4. To keep the JSON out of your app, store it with the Templates endpoint and render by template ID with a `merge` array: https://shotstack.io/docs/guide/architecting-an-application/templates/

## Customise

This template has merge fields. Send a `merge` array with the request to replace them; do not edit the timeline JSON.

| Field | Default |
| --- | --- |
| `{{ S1_Title }}` | Holiday Recap |
| `{{ S1_IMAGE_1 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/7e638a79-0de9-48bc-b69a-6fb1818be099/source.png |
| `{{ S1_IMAGE_2 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/81b63a7d-fd2b-434f-a9c2-f0b6d786be4a/source.png |
| `{{ S1_IMAGE_3 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d1517788-32a6-49e5-9f57-f22e174f941b/source.png |
| `{{ S1_IMAGE_4 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ddadfa2b-6ef6-45fa-820b-dca45552e3f9/source.png |
| `{{ S1_IMAGE_5 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/12d1f2b7-10ea-4a37-97c5-9b34bcfae970/source.png |
| `{{ S1_IMAGE_6 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ebe14028-83c6-462a-9363-c9cbf68ffd23/source.png |
| `{{ S1_IMAGE_7 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d3d20e84-206c-4ad8-91ca-b5af525b54e2/source.png |
| `{{ S1_BACKGROUND_VIDEO }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/2e5e49f3-c626-45be-8976-3f49435f87f9/source.mp4 |
| `{{ IMAGE_1 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d89b6e2a-b33c-4c7d-af5c-33d03801ed0a/source.jpg |
| `{{ IMAGE_2 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/87fb0bdd-8a42-4825-b939-8a4c6e6c7d88/source.jpg |
| `{{ IMAGE_3 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/31a061d5-0267-4dbe-8f6e-56b4a1531a52/source.jpg |
| `{{ IMAGE_4 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/f53f6c1a-6894-4960-943d-ebc67161586f/source.jpg |
| `{{ IMAGE_5 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/18dc4fb2-5a82-4af8-9d4e-58dd5907bd48/source.jpg |
| `{{ IMAGE_6 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/8f54be1f-1eba-4e70-9eb8-b40e92fc7579/source.jpg |
| `{{ IMAGE_7 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/79c531b7-aa5c-4970-9257-b954f3d7ee1e/source.jpg |
| `{{ IMAGE_8 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/cd5f590f-65a9-47ce-8abc-7876f5e87ea0/source.jpg |
| `{{ AUDIO }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/92c115c4-684b-41ce-9cdb-2ac6c485343a/source.mp3 |

## Template JSON

```json
{
  "timeline": {
    "background": "#FFFFFF",
    "tracks": [
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "audio",
              "src": "{{ AUDIO }}",
              "volume": 1
            },
            "start": 0
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_8 }}"
            },
            "start": 14
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_7 }}"
            },
            "start": 13
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_6 }}"
            },
            "start": 12
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_5 }}"
            },
            "start": 11
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_4 }}"
            },
            "start": 10
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_3 }}"
            },
            "start": 9
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_2 }}"
            },
            "start": 8
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_1 }}"
            },
            "start": 7
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S1_Title}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#ffffff",
                "family": "Montserrat ExtraBold",
                "size": "100",
                "lineHeight": 1
              },
              "width": 500,
              "height": 250
            },
            "start": 0.5,
            "length": 6.5,
            "transition": {
              "in": "slideUpSlow"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1.5,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_1 }}"
            },
            "start": 5,
            "scale": 0.4,
            "offset": {
              "x": 0.057,
              "y": 0
            },
            "position": "center",
            "transition": {
              "in": "fade",
              "out": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ca488abb-8845-4e08-bfa2-344c32969948/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 2,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_2 }}"
            },
            "start": 4.5,
            "scale": 0.25,
            "offset": {
              "x": 0,
              "y": -0.063
            },
            "position": "center",
            "transition": {
              "out": "fade",
              "in": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/aa418c0d-aa54-4c0e-b303-02e25fc0253c/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 2.5,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_3 }}"
            },
            "start": 4,
            "scale": 0.4,
            "offset": {
              "x": -0.25,
              "y": 0.118
            },
            "position": "center",
            "transition": {
              "in": "fade",
              "out": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/532da63d-f891-4cd5-80b0-5cc50513c0ba/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 3,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_4 }}"
            },
            "start": 3.5,
            "scale": 0.4,
            "offset": {
              "x": 0.245,
              "y": 0.091
            },
            "position": "center",
            "transition": {
              "out": "fade",
              "in": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/54e71161-7c58-4158-86ae-ea185d954255/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 3.5,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_5 }}"
            },
            "start": 3,
            "scale": 0.4,
            "offset": {
              "x": -0.211,
              "y": -0.176
            },
            "position": "center",
            "transition": {
              "in": "fade",
              "out": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/dafc0b08-cd04-4550-8460-83d9a7706aa3/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_6 }}"
            },
            "start": 2.5,
            "scale": 0.25,
            "offset": {
              "x": 0.085,
              "y": -0.285
            },
            "position": "center",
            "transition": {
              "out": "fade",
              "in": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/10f8371f-d012-4f3f-81e1-7e172e6180f7/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4.5,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_7 }}"
            },
            "start": 2,
            "scale": 0.25,
            "offset": {
              "x": -0.029,
              "y": 0.278
            },
            "position": "center",
            "transition": {
              "in": "fade",
              "out": "fade"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/076c630b-0725-45f8-8d98-9f1e0c1c8b10/source.png"
            },
            "start": 0,
            "length": 7
          }
        ]
      },
      {
        "clips": [
          {
            "length": 7,
            "asset": {
              "type": "video",
              "src": "{{ S1_BACKGROUND_VIDEO }}"
            },
            "start": 0,
            "transition": {
              "out": "fade"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat ExtraBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 1080,
              "height": 1920,
              "background": {
                "color": "#000000"
              }
            },
            "start": 0,
            "length": 15
          }
        ]
      }
    ]
  },
  "output": {
    "format": "mp4",
    "fps": 25,
    "size": {
      "width": 1080,
      "height": 1920
    }
  },
  "merge": [
    {
      "find": "S1_Title",
      "replace": "Holiday Recap"
    },
    {
      "find": "S1_IMAGE_1",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/7e638a79-0de9-48bc-b69a-6fb1818be099/source.png"
    },
    {
      "find": "S1_IMAGE_2",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/81b63a7d-fd2b-434f-a9c2-f0b6d786be4a/source.png"
    },
    {
      "find": "S1_IMAGE_3",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d1517788-32a6-49e5-9f57-f22e174f941b/source.png"
    },
    {
      "find": "S1_IMAGE_4",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ddadfa2b-6ef6-45fa-820b-dca45552e3f9/source.png"
    },
    {
      "find": "S1_IMAGE_5",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/12d1f2b7-10ea-4a37-97c5-9b34bcfae970/source.png"
    },
    {
      "find": "S1_IMAGE_6",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ebe14028-83c6-462a-9363-c9cbf68ffd23/source.png"
    },
    {
      "find": "S1_IMAGE_7",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d3d20e84-206c-4ad8-91ca-b5af525b54e2/source.png"
    },
    {
      "find": "S1_BACKGROUND_VIDEO",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/2e5e49f3-c626-45be-8976-3f49435f87f9/source.mp4"
    },
    {
      "find": "IMAGE_1",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d89b6e2a-b33c-4c7d-af5c-33d03801ed0a/source.jpg"
    },
    {
      "find": "IMAGE_2",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/87fb0bdd-8a42-4825-b939-8a4c6e6c7d88/source.jpg"
    },
    {
      "find": "IMAGE_3",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/31a061d5-0267-4dbe-8f6e-56b4a1531a52/source.jpg"
    },
    {
      "find": "IMAGE_4",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/f53f6c1a-6894-4960-943d-ebc67161586f/source.jpg"
    },
    {
      "find": "IMAGE_5",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/18dc4fb2-5a82-4af8-9d4e-58dd5907bd48/source.jpg"
    },
    {
      "find": "IMAGE_6",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/8f54be1f-1eba-4e70-9eb8-b40e92fc7579/source.jpg"
    },
    {
      "find": "IMAGE_7",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/79c531b7-aa5c-4970-9257-b954f3d7ee1e/source.jpg"
    },
    {
      "find": "IMAGE_8",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/cd5f590f-65a9-47ce-8abc-7876f5e87ea0/source.jpg"
    },
    {
      "find": "AUDIO",
      "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/92c115c4-684b-41ce-9cdb-2ac6c485343a/source.mp3"
    }
  ]
}
```

## Render it

Save the JSON as `template.json`. The sandbox key is free: https://dashboard.shotstack.io/register

### cURL
```bash
# 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"
```

### Node.js
```javascript
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);
```

### Python
```python
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"))
```

### CLI
```bash
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
```

## Agent surfaces

If you are an AI assistant with tool access, the hosted MCP server is the shortest path: connect `https://mcp.shotstack.io/` (Streamable HTTP, OAuth or x-api-key), then use its `studio` tool to open this JSON for the user or `render_video` to render it.

- MCP server (all clients): https://shotstack.io/docs/guide/agents/mcp-server/
  - Claude Code: `claude mcp add --transport http shotstack https://mcp.shotstack.io`
  - Cursor (mcp.json): `{"mcpServers":{"shotstack":{"url":"https://mcp.shotstack.io/"}}}`
  - VS Code (mcp.json): `{"servers":{"shotstack":{"type":"http","url":"https://mcp.shotstack.io/"}}}`
  - Claude.ai / ChatGPT: Settings → Connectors → add custom connector → https://mcp.shotstack.io/
- CLI + agent skill: https://shotstack.io/docs/guide/agents/cli/ — skill file: https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md
- Edit JSON conventions for AI: https://shotstack.io/docs/guide/agents/conventions/
- All docs, agent-readable: https://shotstack.io/docs/guide/llms.txt

### Use the CLI skill (AI coding agents: Claude Code, Cursor, Codex…)

The skill teaches the render, validate, ingest and template commands, so the agent can work this template without trial and error:

```bash
npm install -g @shotstack/cli
curl --create-dirs -o .claude/skills/shotstack/SKILL.md https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md
```

(Claude Code loads it from `.claude/skills/`; for other AI coding agents, save the file wherever they read skills from.) Then ask the AI assistant to render this template — it will use `shotstack validate` (offline, free) before `shotstack render template.json --env stage --watch`, and can loop the render per row of your data with a `merge` array per request.

## Related

- Bulk-create videos from a CSV: https://shotstack.io/learn/bulk-create-videos-from-csv-and-ai/
- Webhooks: https://shotstack.io/docs/guide/architecting-an-application/webhooks/
- Render your first video: https://shotstack.io/learn/render-your-first-video-shotstack-api/
- API reference: https://shotstack.io/docs/api/
- All agent-readable docs: https://shotstack.io/llms.txt