# Family Spring Holiday Promotion (video template) > Promote your spring sales event with this warm, family-focused template. Perfect for seasonal offers and holiday discounts. ## Overview - **Page**: https://shotstack.io/studio/templates/family-spring-holiday-promotion-template/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 10.5s - **Timeline**: 36 clips on 30 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvMmI0OGI2ZGEtMTFlNC00OTNmLThjMmItMzhkYjI4ODllODMwL3NvdXJjZS50dGYifSx7InNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzg0ZDkxN2NjLWNlZGEtNDI0Zi04ODhkLWMyYjYyZGJjOTNjNy9zb3VyY2UudHRmIn1dLCJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTM19TdWJ0aXRsZX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJyaWdodCIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiSHVpbGUgZGUgSmFjaW50aGUiLCJzaXplIjoiMTIwIiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MDAsImhlaWdodCI6MjAwfSwic3RhcnQiOjcsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjotMC4wMywieSI6MC4zODF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjM1Mi41fX0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzNfSU1BR0VfMiB9fSJ9LCJzdGFydCI6Ny42LCJzY2FsZSI6MC41MSwib2Zmc2V0Ijp7IngiOi0wLjAxNCwieSI6LTAuMjMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjotMy4zfX0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZURvd24ifX0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlL2M2MGViYjZhLTFmZWItNDQxNC05YzU3LTE0YzNlNTA4NGQ0OC9zb3VyY2UubXA0In0sInN0YXJ0Ijo3LCJsZW5ndGgiOiJlbmQifV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlL2E0ZmY5MDVmLWU3Y2ItNDg3ZS1iYzFkLTBmMGUxNjEzOGVlNy9zb3VyY2UucG5nIn0sInN0YXJ0Ijo3LjAwNTIyODU3MTQyODU3Miwic2NhbGUiOjAuMTMsIm9mZnNldCI6eyJ4IjotMC4wMjcsInkiOi0wLjE3NX0sInBvc2l0aW9uIjoiY2VudGVyIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTM19WSURFTyB9fSIsInRyaW0iOjAuMjN9LCJzdGFydCI6Ny4yOCwic2NhbGUiOjAuNSwib2Zmc2V0Ijp7IngiOi0wLjAxLCJ5IjotMC4wMDl9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjR9fSwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlTGVmdCJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvYTUwMTJhODctYzgxMC00NWRmLWI1ODUtZTVjNzljYTMxYWI3L3NvdXJjZS5tcDQifSwic3RhcnQiOjcsImxlbmd0aCI6My41fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzE4ZmYxMDFkLTRhNWQtNGEwZC04YTliLTQ1NWQzMDEzNDRjOC9zb3VyY2UucG5nIn0sInN0YXJ0Ijo3LjAwNTIyODU3MTQyODU3Miwic2NhbGUiOjAuMTMsIm9mZnNldCI6eyJ4IjotMC4wMSwieSI6MC4wNDN9LCJwb3NpdGlvbiI6ImNlbnRlciJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzNfSU1BR0VfMSB9fSJ9LCJzdGFydCI6Ny4xLCJzY2FsZSI6MC40Mywib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTI0fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoyfX0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvN2Q5MGQzOGMtZmE4Yy00Nzk1LTkwOGEtZTljZGQzYjViOTBhL3NvdXJjZS5wbmcifSwic3RhcnQiOjcuMDA1MjI4NTcxNDI4NTcyLCJzY2FsZSI6MC42NSwib2Zmc2V0Ijp7IngiOi0wLjAxNCwieSI6LTAuMDcxfSwicG9zaXRpb24iOiJjZW50ZXIifV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzRiMDljNDUwLWE4NDYtNGFhZS05ZTBjLTc5ODdlZjZmODcyOS9zb3VyY2UucG5nIn0sInN0YXJ0Ijo2Ljk5MDk0Mjg1NzE0Mjg1OCwic2NhbGUiOjAuMiwib2Zmc2V0Ijp7IngiOi0wLjAzMSwieSI6MC41MDl9LCJwb3NpdGlvbiI6ImNlbnRlciJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo2MDAsImhlaWdodCI6NjAwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoiIzAwMDAwMCJ9fSwic3RhcnQiOjcsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjIyMiwieSI6LTAuNDY3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoyMS41OX19fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvM2U5NmVlY2YtYTNjYi00YWMxLTg1NTctYzIzNjQzZjQxMTVmL3NvdXJjZS5wbmcifSwic3RhcnQiOjcsImxlbmd0aCI6ImVuZCJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIHt7UzJfU3VidGl0bGV9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJIdWlsZSBkZSBKYWNpbnRoZSIsInNpemUiOiIxMjAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjkwMCwiaGVpZ2h0IjoyMDB9LCJzdGFydCI6My41LCJsZW5ndGgiOjMuNSwib2Zmc2V0Ijp7IngiOi0wLjAxNywieSI6MC4zODV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjM1Mi41fX0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoyLjk3LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMl9JTUFHRV8yIH19In0sInN0YXJ0Ijo0LjAzLCJzY2FsZSI6MC4zLCJvZmZzZXQiOnsieCI6MC4wNzYsInkiOi0wLjMyMn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6NH19LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo2NTAsImhlaWdodCI6NjY2LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1IgfX0ifX0sInN0YXJ0IjozLjUwMTYsImxlbmd0aCI6My41LCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjo0fX0sIm9mZnNldCI6eyJ4IjowLjA3NiwieSI6LTAuMzI2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLjE5LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMl9JTUFHRV8xIH19In0sInN0YXJ0IjozLjgxLCJzY2FsZSI6MC4yMywib2Zmc2V0Ijp7IngiOjAuMjQ3LCJ5IjowLjE4Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6NH19LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo1MDAsImhlaWdodCI6NTM4LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1IgfX0ifX0sInN0YXJ0IjozLjUsImxlbmd0aCI6My41LCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjo0fX0sIm9mZnNldCI6eyJ4IjowLjI0NywieSI6MC4xNzR9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjMuNDMsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMyX1ZJREVPIH19IiwidHJpbSI6MC4wNn0sInN0YXJ0IjozLjU3LCJzY2FsZSI6MC40NSwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6LTZ9fSwib2Zmc2V0Ijp7IngiOjAuMDA4LCJ5IjotMC4wNTF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MjAsImhlaWdodCI6OTc3LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1IgfX0ifX0sInN0YXJ0IjozLjUsImxlbmd0aCI6My41LCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjotNn19LCJvZmZzZXQiOnsieCI6MC4wMDgsInkiOi0wLjA2OH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjgwMCwiaGVpZ2h0Ijo4MDAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19In19LCJzdGFydCI6My41LCJsZW5ndGgiOjMuNSwib2Zmc2V0Ijp7IngiOi0wLjE2LCJ5IjowLjE5NH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6NTMuNjZ9fSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzQ2MTgzZDIxLTI4NDItNGI2ZC05NDNjLTdiZGIzNDE4NmQ5Ni9zb3VyY2UucG5nIn0sInN0YXJ0IjozLjUsImxlbmd0aCI6My41fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6My41LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vZmFtaWx5LXNwcmluZy1ob2xpZGF5LXByb21vdGlvbi10ZW1wbGF0ZS85MzVkODY1NC0yODMxLTQ4YTItYjE1Ny1mOGE0NGRhMzhlNGUvc291cmNlLnBuZyJ9LCJzdGFydCI6My41LCJzY2FsZSI6MC4yLCJvZmZzZXQiOnsieCI6LTAuMDY5LCJ5IjowLjQ5N30sInBvc2l0aW9uIjoiY2VudGVyIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjMuNSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvYjUyYmU4OGItNGFmMS00NjMzLWJhZDMtYmQ0MjIwNzA3NjM0L3NvdXJjZS5wbmcifSwic3RhcnQiOjMuNSwic2NhbGUiOjAuNjUsIm9mZnNldCI6eyJ4IjowLjAzLCJ5IjotMC4wOTh9LCJwb3NpdGlvbiI6ImNlbnRlciJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMV90aXRsZX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ikh1aWxlIGRlIEphY2ludGhlIiwic2l6ZSI6IjEyMCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6OTAwLCJoZWlnaHQiOjIwMH0sInN0YXJ0IjowLCJsZW5ndGgiOjMuNSwib2Zmc2V0Ijp7IngiOi0wLjAxNywieSI6MC4zNTR9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjM1Mi41fX0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLjUsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMxX1ZJREVPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjAsInNjYWxlIjowLjUsIm9mZnNldCI6eyJ4IjotMC4xODcsInkiOi0wLjM4OX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifX0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzhiODU3M2VhLTI0ODEtNGIzNy1iZmY3LTMyYWE3NmNiMjYwYS9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJsZW5ndGgiOjMuNX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjEwMDAsImhlaWdodCI6MTAwMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IFNIQVBFX0NPTE9SIH19IiwiYm9yZGVyUmFkaXVzIjowfX0sInN0YXJ0IjowLCJsZW5ndGgiOjMuNSwib2Zmc2V0Ijp7IngiOi0wLjE4NywieSI6LTAuMzg5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvNzZmMjI2NDctMGI4NC00NDc5LWJiM2QtODI1MThjNTAzMTAzL3NvdXJjZS5wbmcifSwic3RhcnQiOjAsImxlbmd0aCI6My41fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MywiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfMSB9fSJ9LCJzdGFydCI6MC41LCJzY2FsZSI6MC4yNCwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6NH19LCJvZmZzZXQiOnsieCI6MC4yNSwieSI6MC4yMDd9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZURvd24ifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjUwMCwiaGVpZ2h0Ijo1MjcsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBTSEFQRV9DT0xPUiB9fSJ9fSwic3RhcnQiOjAuNTQsImxlbmd0aCI6Mi45NiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6NH19LCJvZmZzZXQiOnsieCI6MC4yNSwieSI6MC4yMDJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLjE4LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV8yIH19In0sInN0YXJ0IjowLjMyLCJzY2FsZSI6MC40NSwib2Zmc2V0Ijp7IngiOjAuMDA4LCJ5IjotMC4wNTN9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi00fX0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MjAsImhlaWdodCI6OTU0LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1IgfX0ifX0sInN0YXJ0IjowLjI3LCJsZW5ndGgiOjMuMjMsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi00fX0sIm9mZnNldCI6eyJ4IjowLjAwOCwieSI6LTAuMDYyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6My41LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vZmFtaWx5LXNwcmluZy1ob2xpZGF5LXByb21vdGlvbi10ZW1wbGF0ZS9lMjEwMzJjZC02ZDJhLTQ0MDItYjYxOC1lZTljYzYyM2ZjYTUvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwic2NhbGUiOjAuNjUsIm9mZnNldCI6eyJ4IjowLjAyLCJ5IjotMC4wNTN9LCJwb3NpdGlvbiI6ImNlbnRlciJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLjUsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzUxODU3MDJiLWY2NGEtNDIzNy04ZjgxLTRiNDZjM2NhM2Y3MC9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJzY2FsZSI6MC4yLCJvZmZzZXQiOnsieCI6MC4wMjUsInkiOjAuNDkyfSwicG9zaXRpb24iOiJjZW50ZXIifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgQkFDS0dST1VORF9DT0xPUl8yIH19In19LCJzdGFydCI6MCwibGVuZ3RoIjoxMC41MX1dfV19LCJvdXRwdXQiOnsiZm9ybWF0IjoibXA0IiwiZnBzIjoyNSwic2l6ZSI6eyJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwfX0sIm1lcmdlIjpbeyJmaW5kIjoiUzFfdGl0bGUiLCJyZXBsYWNlIjoiU3ByaW5nIEhvbGlkYXkgV2l0aCBGYW1pbHkifSx7ImZpbmQiOiJTMV9JTUFHRV8xIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzhhODZjNzFkLWEzNjktNDkyOS1hODg3LTBkYjU5NGIwODUwYy9zb3VyY2UuanBnIn0seyJmaW5kIjoiUzFfSU1BR0VfMiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vZmFtaWx5LXNwcmluZy1ob2xpZGF5LXByb21vdGlvbi10ZW1wbGF0ZS8xODdjYjY1MC0zNWE4LTRlMmQtOWVmZS1lNmU3MGU1ODc4Njkvc291cmNlLmpwZyJ9LHsiZmluZCI6IlMxX1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzE5YmY2MmE4LTkyZDktNDdiOC1iYzBmLTE1NTY0MjY0MDJlMi9zb3VyY2UubXA0In0seyJmaW5kIjoiUzJfU3VidGl0bGUiLCJyZXBsYWNlIjoiUXVhbGl0eSB0aW1lIHdpdGggRGFkICYgS2lkcyJ9LHsiZmluZCI6IlMyX0lNQUdFXzEiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvYjg1M2M0OTUtMmQ1Mi00YWJhLTg0YzctYTg5NDkzZjYxZWNiL3NvdXJjZS5qcGcifSx7ImZpbmQiOiJTMl9JTUFHRV8yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzZkNWYxNDNhLWJiNWYtNGEwOC04YWRhLWM1NWZlNzFlMWRkNi9zb3VyY2UuanBnIn0seyJmaW5kIjoiUzJfVklERU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvZDg1MjRlMDAtYWY4Mi00MjA0LWE0NDAtMDQ3MjM2OWIyMjlkL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTM19TdWJ0aXRsZSIsInJlcGxhY2UiOiJCb25kaW5nIHdpdGggbG92ZWQgb25lcyJ9LHsiZmluZCI6IlMzX0lNQUdFXzEiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvYjdhY2U3NjMtMDMxNS00NDg1LWEzMmQtNGVkMmMwNWFmZTU5L3NvdXJjZS5qcGcifSx7ImZpbmQiOiJTM19JTUFHRV8yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9mYW1pbHktc3ByaW5nLWhvbGlkYXktcHJvbW90aW9uLXRlbXBsYXRlLzc2ZTdiZGIwLTczOTQtNGRhMy04MWZhLTM5MTgxOWJhYjRjMy9zb3VyY2UuanBnIn0seyJmaW5kIjoiUzNfVklERU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2ZhbWlseS1zcHJpbmctaG9saWRheS1wcm9tb3Rpb24tdGVtcGxhdGUvNDhiNjg4ZTAtMTMwOC00ZWJhLWJlZGMtYjU2NTdmZjk5MWZjL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJGT05UX0NPTE9SIiwicmVwbGFjZSI6IiMwMDAwMDAifSx7ImZpbmQiOiJTSEFQRV9DT0xPUiIsInJlcGxhY2UiOiIjZWNlY2U2In0seyJmaW5kIjoiQkFDS0dST1VORF9DT0xPUl8yIiwicmVwbGFjZSI6IiM1MGYxZmEifSx7ImZpbmQiOiJBVURJTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vZmFtaWx5LXNwcmluZy1ob2xpZGF5LXByb21vdGlvbi10ZW1wbGF0ZS8yMjJiNWI3My0zOGQxLTQ0NjQtOTViMS0yNDliMDQ1NzdkYWQvc291cmNlLm1wMyJ9XX0 - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/family-spring-holiday-promotion-template ## 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 }}` | Spring Holiday With Family | | `{{ S1_IMAGE_1 }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/8a86c71d-a369-4929-a887-0db594b0850c/source.jpg | | `{{ S1_IMAGE_2 }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/187cb650-35a8-4e2d-9efe-e6e70e587869/source.jpg | | `{{ S1_VIDEO }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/19bf62a8-92d9-47b8-bc0f-1556426402e2/source.mp4 | | `{{ S2_Subtitle }}` | Quality time with Dad & Kids | | `{{ S2_IMAGE_1 }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/b853c495-2d52-4aba-84c7-a89493f61ecb/source.jpg | | `{{ S2_IMAGE_2 }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/6d5f143a-bb5f-4a08-8ada-c55fe71e1dd6/source.jpg | | `{{ S2_VIDEO }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/d8524e00-af82-4204-a440-0472369b229d/source.mp4 | | `{{ S3_Subtitle }}` | Bonding with loved ones | | `{{ S3_IMAGE_1 }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/b7ace763-0315-4485-a32d-4ed2c05afe59/source.jpg | | `{{ S3_IMAGE_2 }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/76e7bdb0-7394-4da3-81fa-391819bab4c3/source.jpg | | `{{ S3_VIDEO }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/48b688e0-1308-4eba-bedc-b5657ff991fc/source.mp4 | | `{{ FONT_COLOR }}` | #000000 | | `{{ SHAPE_COLOR }}` | #ecece6 | | `{{ BACKGROUND_COLOR_2 }}` | #50f1fa | | `{{ AUDIO }}` | https://templates.shotstack.io/family-spring-holiday-promotion-template/222b5b73-38d1-4464-95b1-249b04577dad/source.mp3 | ## Template JSON ```json { "timeline": { "fonts": [ { "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/2b48b6da-11e4-493f-8c2b-38db2889e830/source.ttf" }, { "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/84d917cc-ceda-424f-888d-c2b62dbc93c7/source.ttf" } ], "background": "#FFFFFF", "tracks": [ { "clips": [ { "length": "end", "asset": { "type": "audio", "src": "{{ AUDIO }}", "volume": 1 }, "start": 0 } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S3_Subtitle}}", "alignment": { "horizontal": "right", "vertical": "center" }, "font": { "color": "{{ FONT_COLOR }}", "family": "Huile de Jacinthe", "size": "120", "lineHeight": 1 }, "width": 900, "height": 200 }, "start": 7, "length": "end", "offset": { "x": -0.03, "y": 0.381 }, "position": "center", "transform": { "rotate": { "angle": 352.5 } }, "transition": { "in": "slideRight" } } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "{{ S3_IMAGE_2 }}" }, "start": 7.6, "scale": 0.51, "offset": { "x": -0.014, "y": -0.232 }, "position": "center", "transform": { "rotate": { "angle": -3.3 } }, "transition": { "in": "slideDown" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/c60ebb6a-1feb-4414-9c57-14c3e5084d48/source.mp4" }, "start": 7, "length": "end" } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/a4ff905f-e7cb-487e-bc1d-0f0e16138ee7/source.png" }, "start": 7.005228571428572, "scale": 0.13, "offset": { "x": -0.027, "y": -0.175 }, "position": "center" } ] }, { "clips": [ { "length": "end", "asset": { "type": "video", "src": "{{ S3_VIDEO }}", "trim": 0.23 }, "start": 7.28, "scale": 0.5, "offset": { "x": -0.01, "y": -0.009 }, "position": "center", "transform": { "rotate": { "angle": 4 } }, "transition": { "in": "slideLeft" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/a5012a87-c810-45df-b585-e5c79ca31ab7/source.mp4" }, "start": 7, "length": 3.5 } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/18ff101d-4a5d-4a0d-8a9b-455d301344c8/source.png" }, "start": 7.005228571428572, "scale": 0.13, "offset": { "x": -0.01, "y": 0.043 }, "position": "center" } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "{{ S3_IMAGE_1 }}" }, "start": 7.1, "scale": 0.43, "offset": { "x": 0, "y": 0.124 }, "position": "center", "transform": { "rotate": { "angle": 2 } }, "transition": { "in": "slideUp" } } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/7d90d38c-fa8c-4795-908a-e9cdd3b5b90a/source.png" }, "start": 7.005228571428572, "scale": 0.65, "offset": { "x": -0.014, "y": -0.071 }, "position": "center" } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/4b09c450-a846-4aae-9e0c-7987ef6f8729/source.png" }, "start": 6.990942857142858, "scale": 0.2, "offset": { "x": -0.031, "y": 0.509 }, "position": "center" } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ FONT_COLOR }}", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 600, "height": 600, "background": { "color": "#000000" } }, "start": 7, "length": "end", "offset": { "x": 0.222, "y": -0.467 }, "position": "center", "transform": { "rotate": { "angle": 21.59 } } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/3e96eecf-a3cb-4ac1-8557-c23643f4115f/source.png" }, "start": 7, "length": "end" } ] }, { "clips": [ { "asset": { "type": "text", "text": " {{S2_Subtitle}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ FONT_COLOR }}", "family": "Huile de Jacinthe", "size": "120", "lineHeight": 1 }, "width": 900, "height": 200 }, "start": 3.5, "length": 3.5, "offset": { "x": -0.017, "y": 0.385 }, "position": "center", "transform": { "rotate": { "angle": 352.5 } }, "transition": { "in": "slideRight" } } ] }, { "clips": [ { "length": 2.97, "asset": { "type": "image", "src": "{{ S2_IMAGE_2 }}" }, "start": 4.03, "scale": 0.3, "offset": { "x": 0.076, "y": -0.322 }, "position": "center", "transform": { "rotate": { "angle": 4 } }, "transition": { "in": "slideLeft" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 650, "height": 666, "background": { "color": "{{ SHAPE_COLOR }}" } }, "start": 3.5016, "length": 3.5, "transform": { "rotate": { "angle": 4 } }, "offset": { "x": 0.076, "y": -0.326 }, "position": "center", "transition": { "in": "slideLeft" } } ] }, { "clips": [ { "length": 3.19, "asset": { "type": "image", "src": "{{ S2_IMAGE_1 }}" }, "start": 3.81, "scale": 0.23, "offset": { "x": 0.247, "y": 0.182 }, "position": "center", "transform": { "rotate": { "angle": 4 } }, "transition": { "in": "slideLeft" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 500, "height": 538, "background": { "color": "{{ SHAPE_COLOR }}" } }, "start": 3.5, "length": 3.5, "transform": { "rotate": { "angle": 4 } }, "offset": { "x": 0.247, "y": 0.174 }, "position": "center", "transition": { "in": "slideLeft" } } ] }, { "clips": [ { "length": 3.43, "asset": { "type": "video", "src": "{{ S2_VIDEO }}", "trim": 0.06 }, "start": 3.57, "scale": 0.45, "transform": { "rotate": { "angle": -6 } }, "offset": { "x": 0.008, "y": -0.051 }, "position": "center", "transition": { "in": "slideRight" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 920, "height": 977, "background": { "color": "{{ SHAPE_COLOR }}" } }, "start": 3.5, "length": 3.5, "transform": { "rotate": { "angle": -6 } }, "offset": { "x": 0.008, "y": -0.068 }, "position": "center", "transition": { "in": "slideRight" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 800, "height": 800, "background": { "color": "{{ FONT_COLOR }}" } }, "start": 3.5, "length": 3.5, "offset": { "x": -0.16, "y": 0.194 }, "position": "center", "transform": { "rotate": { "angle": 53.66 } }, "transition": { "in": "fade" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/46183d21-2842-4b6d-943c-7bdb34186d96/source.png" }, "start": 3.5, "length": 3.5 } ] }, { "clips": [ { "length": 3.5, "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/935d8654-2831-48a2-b157-f8a44da38e4e/source.png" }, "start": 3.5, "scale": 0.2, "offset": { "x": -0.069, "y": 0.497 }, "position": "center" } ] }, { "clips": [ { "length": 3.5, "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/b52be88b-4af1-4633-bad3-bd4220707634/source.png" }, "start": 3.5, "scale": 0.65, "offset": { "x": 0.03, "y": -0.098 }, "position": "center" } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_title}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ FONT_COLOR }}", "family": "Huile de Jacinthe", "size": "120", "lineHeight": 1 }, "width": 900, "height": 200 }, "start": 0, "length": 3.5, "offset": { "x": -0.017, "y": 0.354 }, "position": "center", "transform": { "rotate": { "angle": 352.5 } }, "transition": { "in": "slideRight" } } ] }, { "clips": [ { "length": 3.5, "asset": { "type": "video", "src": "{{ S1_VIDEO }}", "volume": 1 }, "start": 0, "scale": 0.5, "offset": { "x": -0.187, "y": -0.389 }, "position": "center", "transition": { "in": "slideRight" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/8b8573ea-2481-4b37-bff7-32aa76cb260a/source.png" }, "start": 0, "length": 3.5 } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 1000, "height": 1000, "background": { "color": "{{ SHAPE_COLOR }}", "borderRadius": 0 } }, "start": 0, "length": 3.5, "offset": { "x": -0.187, "y": -0.389 }, "position": "center", "transition": { "in": "slideRight" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/76f22647-0b84-4479-bb3d-82518c503103/source.png" }, "start": 0, "length": 3.5 } ] }, { "clips": [ { "length": 3, "asset": { "type": "image", "src": "{{ S1_IMAGE_1 }}" }, "start": 0.5, "scale": 0.24, "transform": { "rotate": { "angle": 4 } }, "offset": { "x": 0.25, "y": 0.207 }, "position": "center", "transition": { "in": "slideDown" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 500, "height": 527, "background": { "color": "{{ SHAPE_COLOR }}" } }, "start": 0.54, "length": 2.96, "transform": { "rotate": { "angle": 4 } }, "offset": { "x": 0.25, "y": 0.202 }, "position": "center", "transition": { "in": "slideRight" } } ] }, { "clips": [ { "length": 3.18, "asset": { "type": "image", "src": "{{ S1_IMAGE_2 }}" }, "start": 0.32, "scale": 0.45, "offset": { "x": 0.008, "y": -0.053 }, "position": "center", "transform": { "rotate": { "angle": -4 } }, "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat SemiBold", "size": 24, "lineHeight": 1 }, "width": 920, "height": 954, "background": { "color": "{{ SHAPE_COLOR }}" } }, "start": 0.27, "length": 3.23, "transform": { "rotate": { "angle": -4 } }, "offset": { "x": 0.008, "y": -0.062 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "length": 3.5, "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/e21032cd-6d2a-4402-b618-ee9cc623fca5/source.png" }, "start": 0, "scale": 0.65, "offset": { "x": 0.02, "y": -0.053 }, "position": "center" } ] }, { "clips": [ { "length": 3.5, "asset": { "type": "image", "src": "https://templates.shotstack.io/family-spring-holiday-promotion-template/5185702b-f64a-4237-8f81-4b46c3ca3f70/source.png" }, "start": 0, "scale": 0.2, "offset": { "x": 0.025, "y": 0.492 }, "position": "center" } ] }, { "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_2 }}" } }, "start": 0, "length": 10.51 } ] } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 } }, "merge": [ { "find": "S1_title", "replace": "Spring Holiday With Family" }, { "find": "S1_IMAGE_1", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/8a86c71d-a369-4929-a887-0db594b0850c/source.jpg" }, { "find": "S1_IMAGE_2", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/187cb650-35a8-4e2d-9efe-e6e70e587869/source.jpg" }, { "find": "S1_VIDEO", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/19bf62a8-92d9-47b8-bc0f-1556426402e2/source.mp4" }, { "find": "S2_Subtitle", "replace": "Quality time with Dad & Kids" }, { "find": "S2_IMAGE_1", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/b853c495-2d52-4aba-84c7-a89493f61ecb/source.jpg" }, { "find": "S2_IMAGE_2", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/6d5f143a-bb5f-4a08-8ada-c55fe71e1dd6/source.jpg" }, { "find": "S2_VIDEO", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/d8524e00-af82-4204-a440-0472369b229d/source.mp4" }, { "find": "S3_Subtitle", "replace": "Bonding with loved ones" }, { "find": "S3_IMAGE_1", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/b7ace763-0315-4485-a32d-4ed2c05afe59/source.jpg" }, { "find": "S3_IMAGE_2", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/76e7bdb0-7394-4da3-81fa-391819bab4c3/source.jpg" }, { "find": "S3_VIDEO", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/48b688e0-1308-4eba-bedc-b5657ff991fc/source.mp4" }, { "find": "FONT_COLOR", "replace": "#000000" }, { "find": "SHAPE_COLOR", "replace": "#ecece6" }, { "find": "BACKGROUND_COLOR_2", "replace": "#50f1fa" }, { "find": "AUDIO", "replace": "https://templates.shotstack.io/family-spring-holiday-promotion-template/222b5b73-38d1-4464-95b1-249b04577dad/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