# National Holiday Travel & Sales Promotion Template (video template)
> A dynamic, video-themed template to promote national holiday sales, travel offers, and special marketing events effectively.
## Overview
- **Page**: https://shotstack.io/studio/templates/national-holiday-sale-promo-travel-offer-v2/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 16s
- **Timeline**: 27 clips on 22 tracks; assets: audio, luma, rich-text, svg, 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL25hdGlvbmFsLWhvbGlkYXktc2FsZS1wcm9tby10cmF2ZWwtb2ZmZXIvMGM3NmYxZjMtYWMxYS00MGQ3LThiOTgtN2E1ZjMxOTE4YWE5L3NvdXJjZS5vdGYifSx7InNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9uYXRpb25hbC1ob2xpZGF5LXNhbGUtcHJvbW8tdHJhdmVsLW9mZmVyLzBkZTk1MzRhLTI2ZTctNGI3Ny05MWQ1LWVhZTg4MDY3Mzg4OS9zb3VyY2Uub3RmIn1dLCJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPX1NSQyB9fSIsInZvbHVtZSI6MX0sInN0YXJ0IjowfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgMzUwIDIwMFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjM1MFwiIGhlaWdodD1cIjIwMFwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SXzEgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjoxMiwibGVuZ3RoIjo0LCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMTkyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9LCJ3aWR0aCI6MzUwLCJoZWlnaHQiOjIwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9uYXRpb25hbC1ob2xpZGF5LXNhbGUtcHJvbW8tdHJhdmVsLW9mZmVyLzliZTZjZWQzLTkxZTYtNGE4YS04NDAwLTg5NmQ1YmEzNzBhOC9zb3VyY2UucG5nIn0sInN0YXJ0IjoxMiwibGVuZ3RoIjo0fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tCb2R5fX0iLCJmb250Ijp7ImZhbWlseSI6IkFncmFuZGlyIiwic2l6ZSI6ODYsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0IjoxMiwibGVuZ3RoIjo0LCJvZmZzZXQiOnsieCI6MCwieSI6MC4wMzF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIn0sIndpZHRoIjo2MDAsImhlaWdodCI6OTAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgODgwIDE3MjBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI4ODBcIiBoZWlnaHQ9XCIxNzIwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjEyLCJsZW5ndGgiOjQsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIn0sInBvc2l0aW9uIjoiY2VudGVyIiwid2lkdGgiOjg4MCwiaGVpZ2h0IjoxNzIwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL25hdGlvbmFsLWhvbGlkYXktc2FsZS1wcm9tby10cmF2ZWwtb2ZmZXIvOTRjZTRmNGEtM2MxYS00NTM0LWFiMWQtMDlhZTA0YzkyNjU5L3NvdXJjZS5tcDQifSwic3RhcnQiOjEyLCJsZW5ndGgiOjR9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA5MjIgMTcwNFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjkyMlwiIGhlaWdodD1cIjE3MDRcIiBmaWxsPVwie3sgQkFDS0dST1VORF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjEyLCJsZW5ndGgiOjQsInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwid2lkdGgiOjkyMiwiaGVpZ2h0IjoxNzA0fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL25hdGlvbmFsLWhvbGlkYXktc2FsZS1wcm9tby10cmF2ZWwtb2ZmZXIvYmY5YjJjMmMtNzIyNi00ZGEwLWE0YzAtYTEwNzIyNDhhY2UyL3NvdXJjZS5wbmcifSwic3RhcnQiOjEyLCJsZW5ndGgiOjR9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTNF9WSURFTyB9fSIsInZvbHVtZSI6MH0sInN0YXJ0IjoxMiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwiZml0IjoiY3JvcCIsIndpZHRoIjoxMTAwLCJoZWlnaHQiOjE5MzEsIm9mZnNldCI6eyJ4IjowLjAwOTEwMDU4MjQzNzI3NTk3MiwieSI6LTAuMDAyNzUxMTc2MDc1MjY4ODAxOH19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MzX3N1YnRpdGxlXzJ9fSIsImZvbnQiOnsiZmFtaWx5IjoiQWdyYW5kaXIiLCJzaXplIjoxMjAsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJ0eXBld3JpdGVyIiwic3R5bGUiOiJjaGFyYWN0ZXIifX0sInN0YXJ0Ijo4LCJsZW5ndGgiOjQuNywib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjA1OX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUiLCJvdXQiOiJmYWRlIn0sIndpZHRoIjo3MDAsImhlaWdodCI6MTUwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTM19TdWJ0aXRsZV8xfX0iLCJmb250Ijp7ImZhbWlseSI6IkFncmFuZGlyIiwic2l6ZSI6MTIwLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoidHlwZXdyaXRlciIsInN0eWxlIjoiY2hhcmFjdGVyIn19LCJzdGFydCI6OCwibGVuZ3RoIjo0LjcsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjI2OH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJmYWRlIiwiaW4iOiJmYWRlIn0sIndpZHRoIjo3MDAsImhlaWdodCI6MTUwfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NC43LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTM19WSURFT18yIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjgsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMDY1NDAwOTE5NTk2MzU0MTZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIiwib3V0IjoiZmFkZSJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjc3MCwiaGVpZ2h0Ijo1ODJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjcsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMzX1ZJREVPXzEgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6OCwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjI2NX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJmYWRlIiwiaW4iOiJmYWRlIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6NzcwLCJoZWlnaHQiOjU4Mn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDg2NCAxNjkyXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiODY0XCIgaGVpZ2h0PVwiMTY5MlwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SXzEgfX1cIi8-PC9zdmc-In0sInN0YXJ0Ijo4LCJsZW5ndGgiOjQuNywidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUiLCJvdXQiOiJmYWRlIn0sIndpZHRoIjo4NjQsImhlaWdodCI6MTY5Mn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDEwODAgMTkyMFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjEwODBcIiBoZWlnaHQ9XCIxOTIwXCIgZmlsbD1cInt7IEJBQ0tHUk9VTkRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0Ijo4LCJsZW5ndGgiOjQuNywidHJhbnNpdGlvbiI6eyJvdXQiOiJmYWRlIiwiaW4iOiJmYWRlIn0sInBvc2l0aW9uIjoiY2VudGVyIiwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UzJfU3VidGl0bGV9fSIsImZvbnQiOnsiZmFtaWx5IjoiQWdyYW5kaXIiLCJzaXplIjoxMjAsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJ0eXBld3JpdGVyIiwic3R5bGUiOiJjaGFyYWN0ZXIifX0sInN0YXJ0Ijo0LCJsZW5ndGgiOjQuNywidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUiLCJvdXQiOiJmYWRlIn0sIndpZHRoIjo3MDAsImhlaWdodCI6MTYyfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgODgwIDE3MjBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI4ODBcIiBoZWlnaHQ9XCIxNzIwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjQsImxlbmd0aCI6NC43LCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUiLCJpbiI6ImZhZGUifSwid2lkdGgiOjg4MCwiaGVpZ2h0IjoxNzIwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL25hdGlvbmFsLWhvbGlkYXktc2FsZS1wcm9tby10cmF2ZWwtb2ZmZXIvOGQxZjdlOTYtODVlOS00NjUzLTg0YTYtYTc2YzY4OWI5ZTY5L3NvdXJjZS5tcDQifSwic3RhcnQiOjQsImxlbmd0aCI6NC43fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NC43LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTMl9WSURFTyB9fSIsInZvbHVtZSI6MH0sInN0YXJ0Ijo0LCJzY2FsZSI6MSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUiLCJvdXQiOiJmYWRlIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL25hdGlvbmFsLWhvbGlkYXktc2FsZS1wcm9tby10cmF2ZWwtb2ZmZXIvODc1MWE5M2QtMWI4YS00ZDdjLWE0MjItMDkwNjFkNzYzZWVkL3NvdXJjZS5wbmcifSwic3RhcnQiOjQsImxlbmd0aCI6NC43fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgMTA4MCAxOTIwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMTA4MFwiIGhlaWdodD1cIjE5MjBcIiBmaWxsPVwie3sgQkFDS0dST1VORF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjQsImxlbmd0aCI6NC43LCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUiLCJpbiI6ImZhZGUifSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDMwMCA1XCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMzAwXCIgaGVpZ2h0PVwiNVwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SXzEgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjowLCJsZW5ndGgiOjQuNywib2Zmc2V0Ijp7InkiOi0wLjAxOCwieCI6MC4xMzJ9LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6ImZhZGUifSwid2lkdGgiOjMwMCwiaGVpZ2h0Ijo1fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTMV9Qcm9kdWNlcn19IiwiZm9udCI6eyJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjQ2LCJ3ZWlnaHQiOjgwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoiZmFkZUluIiwic3R5bGUiOiJ3b3JkIn19LCJzdGFydCI6MCwibGVuZ3RoIjo0LjcsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4wOX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAiLCJvdXQiOiJmYWRlIn0sIndpZHRoIjo3MDAsImhlaWdodCI6NzJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MxX1RpdGxlXzJ9fSIsImZvbnQiOnsiZmFtaWx5IjoiQWdyYW5kaXIiLCJzaXplIjoxMjAsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoiZmFkZUluIiwic3R5bGUiOiJ3b3JkIn19LCJzdGFydCI6MCwibGVuZ3RoIjo0LjcsIm9mZnNldCI6eyJ4IjowLjE3MiwieSI6MC4wNjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sIndpZHRoIjo0NTAsImhlaWdodCI6MjUwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTMV9UaXRsZV8xfX0iLCJmb250Ijp7ImZhbWlseSI6IkJ1cmd1ZXMgU2NyaXB0Iiwic2l6ZSI6MTIwLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAsImxlbmd0aCI6NC43LCJvZmZzZXQiOnsieCI6LTAuMTYsInkiOjAuMDkzfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSIsIm91dCI6ImZhZGUifSwid2lkdGgiOjMwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjcsImZpdCI6ImNvbnRhaW4iLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbmF0aW9uYWwtaG9saWRheS1zYWxlLXByb21vLXRyYXZlbC1vZmZlci9pMWg1dGdncWx2OXJtOHJlbDU5OTN5OWEvc291cmNlX2NhYzQ2ZDExLndlYm0ifSwic3RhcnQiOjAsInNjYWxlIjoxLCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUifSwid2lkdGgiOjk5MCwiaGVpZ2h0IjoxNzIwLCJvZmZzZXQiOnsieCI6MCwieSI6MH19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjcsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMxX1ZJREVPIH19Iiwidm9sdW1lIjowfSwic3RhcnQiOjAsImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJvZmZzZXQiOnsieCI6MCwieSI6MH19XX1dfSwib3V0cHV0Ijp7ImZvcm1hdCI6Im1wNCIsImZwcyI6MjUsInNpemUiOnsid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH0sImRlc3RpbmF0aW9ucyI6W3sicHJvdmlkZXIiOiJzaG90c3RhY2sifV19LCJtZXJnZSI6W3siZmluZCI6IlMxX1RpdGxlXzEiLCJyZXBsYWNlIjoiVGhlIn0seyJmaW5kIjoiUzFfVGl0bGVfMiIsInJlcGxhY2UiOiJJTkRJQSBUT1VSIn0seyJmaW5kIjoiUzFfUHJvZHVjZXIiLCJyZXBsYWNlIjoiQnkgVHJhdmVsIFN1cnZleSJ9LHsiZmluZCI6IlMxX1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9uYXRpb25hbC1ob2xpZGF5LXNhbGUtcHJvbW8tdHJhdmVsLW9mZmVyLzAyYTIxN2YwLWExMTQtNGY5My1hMjk4LTY1OTAzYWEwMWMzMy9zb3VyY2UubXA0In0seyJmaW5kIjoiUzJfVklERU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL25hdGlvbmFsLWhvbGlkYXktc2FsZS1wcm9tby10cmF2ZWwtb2ZmZXIvMTg2MGU0ZDUtMDU4OS00YjA2LWI2YmQtY2Q4ZDcxOTFiYWUyL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTMl9TdWJ0aXRsZSIsInJlcGxhY2UiOiJCVUlMRElOR1MifSx7ImZpbmQiOiJTM19WSURFT18xIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9uYXRpb25hbC1ob2xpZGF5LXNhbGUtcHJvbW8tdHJhdmVsLW9mZmVyLzJjOWIwZGIwLTI0YjItNGViOC1iMTdiLWNlYTUzZjYzMzNhNC9zb3VyY2UubXA0In0seyJmaW5kIjoiUzNfVklERU9fMiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbmF0aW9uYWwtaG9saWRheS1zYWxlLXByb21vLXRyYXZlbC1vZmZlci85NGI1ZjA0Mi0xODBlLTRjZTAtYjgwMi1hZDlmMDMwNjRjMjcvc291cmNlLm1wNCJ9LHsiZmluZCI6IlMzX1N1YnRpdGxlXzEiLCJyZXBsYWNlIjoiQ1VMVFVSRSJ9LHsiZmluZCI6IlMzX3N1YnRpdGxlXzIiLCJyZXBsYWNlIjoiRk9PRCJ9LHsiZmluZCI6IlM0X1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9uYXRpb25hbC1ob2xpZGF5LXNhbGUtcHJvbW8tdHJhdmVsLW9mZmVyLzdkYTgxMjQ5LWIxMmEtNDY0Ni1iMzU1LWRhNTNlODRlYzQ5NS9zb3VyY2UubXA0In0seyJmaW5kIjoiQm9keSIsInJlcGxhY2UiOiJGUk9NIFRIRSBDT0xPUlMgT0YgSkFJUFVSIFRPIFRIRSBDQUxNIE9GIEtFUkFMQSwgSU5ESUEgSVMgUFVSRSBNQUdJQy4ifSx7ImZpbmQiOiJGT05UX0NPTE9SXzEiLCJyZXBsYWNlIjoiI2ZmZmZmZiJ9LHsiZmluZCI6IkZPTlRfQ09MT1JfMiIsInJlcGxhY2UiOiIjZjBkYzAwIn0seyJmaW5kIjoiQkFDS0dST1VORF9DT0xPUiIsInJlcGxhY2UiOiIjMDAwMDAwIn0seyJmaW5kIjoiQVVESU9fU1JDIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9uYXRpb25hbC1ob2xpZGF5LXNhbGUtcHJvbW8tdHJhdmVsLW9mZmVyLzM0OGNhNzM2LTM1NTUtNDZkMC1iMTUzLTk4NmVkZmVmYjYxYy9zb3VyY2UubXAzIn1dfQ
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/national-holiday-sale-promo-travel-offer-v2
## 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_1 }}` | The |
| `{{ S1_Title_2 }}` | INDIA TOUR |
| `{{ S1_Producer }}` | By Travel Survey |
| `{{ S1_VIDEO }}` | https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/02a217f0-a114-4f93-a298-65903aa01c33/source.mp4 |
| `{{ S2_VIDEO }}` | https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/1860e4d5-0589-4b06-b6bd-cd8d7191bae2/source.mp4 |
| `{{ S2_Subtitle }}` | BUILDINGS |
| `{{ S3_VIDEO_1 }}` | https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/2c9b0db0-24b2-4eb8-b17b-cea53f6333a4/source.mp4 |
| `{{ S3_VIDEO_2 }}` | https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/94b5f042-180e-4ce0-b802-ad9f03064c27/source.mp4 |
| `{{ S3_Subtitle_1 }}` | CULTURE |
| `{{ S3_subtitle_2 }}` | FOOD |
| `{{ S4_VIDEO }}` | https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/7da81249-b12a-4646-b355-da53e84ec495/source.mp4 |
| `{{ Body }}` | FROM THE COLORS OF JAIPUR TO THE CALM OF KERALA, INDIA IS PURE MAGIC. |
| `{{ FONT_COLOR_1 }}` | #ffffff |
| `{{ FONT_COLOR_2 }}` | #f0dc00 |
| `{{ BACKGROUND_COLOR }}` | #000000 |
| `{{ AUDIO_SRC }}` | https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/348ca736-3555-46d0-b153-986edfefb61c/source.mp3 |
## Template JSON
```json
{
"timeline": {
"fonts": [
{
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/0c76f1f3-ac1a-40d7-8b98-7a5f31918aa9/source.otf"
},
{
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/0de9534a-26e7-4b77-91d5-eae880673889/source.otf"
}
],
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO_SRC }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 12,
"length": 4,
"offset": {
"x": 0,
"y": -0.192
},
"position": "center",
"transition": {
"in": "fade"
},
"width": 350,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/9be6ced3-91e6-4a8a-8400-896d5ba370a8/source.png"
},
"start": 12,
"length": 4
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Body}}",
"font": {
"family": "Agrandir",
"size": 86,
"weight": 400,
"color": "{{ FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"start": 12,
"length": 4,
"offset": {
"x": 0,
"y": 0.031
},
"position": "center",
"transition": {
"in": "fade"
},
"width": 600,
"height": 900
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 12,
"length": 4,
"transition": {
"in": "fade"
},
"position": "center",
"width": 880,
"height": 1720
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/94ce4f4a-3c1a-4534-ab1d-09ae04c92659/source.mp4"
},
"start": 12,
"length": 4
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 12,
"length": 4,
"position": "center",
"transition": {
"in": "fade"
},
"width": 922,
"height": 1704
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/bf9b2c2c-7226-4da0-a4c0-a1072248ace2/source.png"
},
"start": 12,
"length": 4
}
]
},
{
"clips": [
{
"length": 4,
"asset": {
"type": "video",
"src": "{{ S4_VIDEO }}",
"volume": 0
},
"start": 12,
"transition": {
"in": "fade"
},
"fit": "crop",
"width": 1100,
"height": 1931,
"offset": {
"x": 0.009100582437275972,
"y": -0.0027511760752688018
}
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S3_subtitle_2}}",
"font": {
"family": "Agrandir",
"size": 120,
"weight": 400,
"color": "{{ FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "typewriter",
"style": "character"
}
},
"start": 8,
"length": 4.7,
"offset": {
"x": 0,
"y": -0.059
},
"position": "center",
"transition": {
"in": "fade",
"out": "fade"
},
"width": 700,
"height": 150
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S3_Subtitle_1}}",
"font": {
"family": "Agrandir",
"size": 120,
"weight": 400,
"color": "{{ FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "typewriter",
"style": "character"
}
},
"start": 8,
"length": 4.7,
"offset": {
"x": 0,
"y": 0.268
},
"position": "center",
"transition": {
"out": "fade",
"in": "fade"
},
"width": 700,
"height": 150
}
]
},
{
"clips": [
{
"length": 4.7,
"asset": {
"type": "video",
"src": "{{ S3_VIDEO_2 }}",
"volume": 1
},
"start": 8,
"scale": 1,
"offset": {
"x": 0,
"y": -0.06540091959635416
},
"position": "center",
"transition": {
"in": "fade",
"out": "fade"
},
"fit": "contain",
"width": 770,
"height": 582
}
]
},
{
"clips": [
{
"length": 4.7,
"asset": {
"type": "video",
"src": "{{ S3_VIDEO_1 }}",
"volume": 1
},
"start": 8,
"scale": 1,
"offset": {
"x": 0,
"y": 0.265
},
"position": "center",
"transition": {
"out": "fade",
"in": "fade"
},
"fit": "contain",
"width": 770,
"height": 582
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 8,
"length": 4.7,
"transition": {
"in": "fade",
"out": "fade"
},
"width": 864,
"height": 1692
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 8,
"length": 4.7,
"transition": {
"out": "fade",
"in": "fade"
},
"position": "center",
"width": 1080,
"height": 1920
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S2_Subtitle}}",
"font": {
"family": "Agrandir",
"size": 120,
"weight": 400,
"color": "{{ FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "typewriter",
"style": "character"
}
},
"start": 4,
"length": 4.7,
"transition": {
"in": "fade",
"out": "fade"
},
"width": 700,
"height": 162
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 4,
"length": 4.7,
"transition": {
"out": "fade",
"in": "fade"
},
"width": 880,
"height": 1720
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/8d1f7e96-85e9-4653-84a6-a76c689b9e69/source.mp4"
},
"start": 4,
"length": 4.7
}
]
},
{
"clips": [
{
"length": 4.7,
"asset": {
"type": "video",
"src": "{{ S2_VIDEO }}",
"volume": 0
},
"start": 4,
"scale": 1,
"transition": {
"in": "fade",
"out": "fade"
},
"fit": "contain",
"width": 1080,
"height": 1920
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/8751a93d-1b8a-4d7c-a422-09061d763eed/source.png"
},
"start": 4,
"length": 4.7
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 4,
"length": 4.7,
"transition": {
"out": "fade",
"in": "fade"
},
"width": 1080,
"height": 1920
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0,
"length": 4.7,
"offset": {
"y": -0.018,
"x": 0.132
},
"transition": {
"in": "slideRight",
"out": "fade"
},
"width": 300,
"height": 5
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S1_Producer}}",
"font": {
"family": "Montserrat ExtraBold",
"size": 46,
"weight": 800,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"start": 0,
"length": 4.7,
"offset": {
"x": 0,
"y": -0.09
},
"position": "center",
"transition": {
"in": "slideUp",
"out": "fade"
},
"width": 700,
"height": 72
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S1_Title_2}}",
"font": {
"family": "Agrandir",
"size": 120,
"weight": 400,
"color": "{{ FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"start": 0,
"length": 4.7,
"offset": {
"x": 0.172,
"y": 0.065
},
"position": "center",
"transition": {
"in": "slideUp"
},
"width": 450,
"height": 250
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S1_Title_1}}",
"font": {
"family": "Burgues Script",
"size": 120,
"weight": 400,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 0,
"length": 4.7,
"offset": {
"x": -0.16,
"y": 0.093
},
"position": "center",
"transition": {
"in": "fade",
"out": "fade"
},
"width": 300,
"height": 200
}
]
},
{
"clips": [
{
"length": 4.7,
"fit": "contain",
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/i1h5tggqlv9rm8rel5993y9a/source_cac46d11.webm"
},
"start": 0,
"scale": 1,
"transition": {
"out": "fade"
},
"width": 990,
"height": 1720,
"offset": {
"x": 0,
"y": 0
}
}
]
},
{
"clips": [
{
"length": 4.7,
"asset": {
"type": "video",
"src": "{{ S1_VIDEO }}",
"volume": 0
},
"start": 0,
"fit": "contain",
"width": 1080,
"height": 1920,
"offset": {
"x": 0,
"y": 0
}
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1080,
"height": 1920
},
"destinations": [
{
"provider": "shotstack"
}
]
},
"merge": [
{
"find": "S1_Title_1",
"replace": "The"
},
{
"find": "S1_Title_2",
"replace": "INDIA TOUR"
},
{
"find": "S1_Producer",
"replace": "By Travel Survey"
},
{
"find": "S1_VIDEO",
"replace": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/02a217f0-a114-4f93-a298-65903aa01c33/source.mp4"
},
{
"find": "S2_VIDEO",
"replace": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/1860e4d5-0589-4b06-b6bd-cd8d7191bae2/source.mp4"
},
{
"find": "S2_Subtitle",
"replace": "BUILDINGS"
},
{
"find": "S3_VIDEO_1",
"replace": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/2c9b0db0-24b2-4eb8-b17b-cea53f6333a4/source.mp4"
},
{
"find": "S3_VIDEO_2",
"replace": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/94b5f042-180e-4ce0-b802-ad9f03064c27/source.mp4"
},
{
"find": "S3_Subtitle_1",
"replace": "CULTURE"
},
{
"find": "S3_subtitle_2",
"replace": "FOOD"
},
{
"find": "S4_VIDEO",
"replace": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/7da81249-b12a-4646-b355-da53e84ec495/source.mp4"
},
{
"find": "Body",
"replace": "FROM THE COLORS OF JAIPUR TO THE CALM OF KERALA, INDIA IS PURE MAGIC."
},
{
"find": "FONT_COLOR_1",
"replace": "#ffffff"
},
{
"find": "FONT_COLOR_2",
"replace": "#f0dc00"
},
{
"find": "BACKGROUND_COLOR",
"replace": "#000000"
},
{
"find": "AUDIO_SRC",
"replace": "https://templates.shotstack.io/national-holiday-sale-promo-travel-offer/348ca736-3555-46d0-b153-986edfefb61c/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