# Summer Holiday Recap & Review Template (video template) > Effortlessly create a dynamic summer holiday recap. This template is perfect for sharing your favourite moments, travels, or event highlights. ## Overview - **Page**: https://shotstack.io/studio/templates/summer-holiday-recap-review-story-template-highlights-v2/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 14.7s - **Timeline**: 15 clips on 15 tracks; assets: audio, rich-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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3N1bW1lci1ob2xpZGF5LXJlY2FwLXJldmlldy1zdG9yeS10ZW1wbGF0ZS1oaWdobGlnaHRzL2RhODUxZTg5LWI0ZDctNDc0NC1iMTI5LTM3YTI2NDU0MzJhOC9zb3VyY2Uub3RmIn1dLCJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1M3X1N1YnRpdGxlXzJ9fSIsImZvbnQiOnsiZmFtaWx5IjoiSG9saWRheUZyZWUiLCJzaXplIjo4MCwid2VpZ2h0Ijo0MDAsImNvbG9yIjoie3sgRk9OVF9DT0xPUl8yIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjoxMS41NywibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjA3Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImNhcm91c2VsVXAifSwid2lkdGgiOjkwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1M3X1N1YnRpdGxlXzF9fSIsImZvbnQiOnsiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjoxMzAsIndlaWdodCI6ODAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMSB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MTEuMjgsImxlbmd0aCI6ImVuZCIsInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImNhcm91c2VsVXAifSwid2lkdGgiOjgwMCwiaGVpZ2h0Ijo0MDB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLjcsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9zdW1tZXItaG9saWRheS1yZWNhcC1yZXZpZXctc3RvcnktdGVtcGxhdGUtaGlnaGxpZ2h0cy9iNDFmM2NlMy02MDM0LTQ1YjktYTFmZi1lYjNhZDQ3YzBhNzMvc291cmNlLm1wNCIsInZvbHVtZSI6MH0sInN0YXJ0IjoxMSwidHJhbnNpdGlvbiI6eyJpbiI6ImNhcm91c2VsVXAifSwicG9zaXRpb24iOiJjZW50ZXIiLCJmaXQiOiJjb250YWluIiwid2lkdGgiOjEwODcsImhlaWdodCI6MjA1Mywib2Zmc2V0Ijp7IngiOjAsInkiOjB9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTNl9TdWJ0aXRsZX19IiwiZm9udCI6eyJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjEzMCwid2VpZ2h0Ijo4MDAsImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0Ijo5LjE2LCJsZW5ndGgiOjIuNTQsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjIzN30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJjYXJvdXNlbFVwIiwiaW4iOiJjYXJvdXNlbERvd24ifSwid2lkdGgiOjgwMCwiaGVpZ2h0Ijo0MDB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoyLjcsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFM2X1ZJREVPIH19Iiwidm9sdW1lIjowfSwic3RhcnQiOjksInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbERvd24iLCJvdXQiOiJjYXJvdXNlbFVwIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MTA4NywiaGVpZ2h0IjoyMDUzLCJvZmZzZXQiOnsieCI6MCwieSI6MH19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1M0X1N1YnRpdGxlfX0iLCJmb250Ijp7ImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6MTMwLCJ3ZWlnaHQiOjgwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoiZmFkZUluIiwic3R5bGUiOiJ3b3JkIn19LCJzdGFydCI6Ny4xNSwibGVuZ3RoIjoyLjU1LCJvZmZzZXQiOnsieCI6MCwieSI6MC4yMzd9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbFJpZ2h0Iiwib3V0IjoiY2Fyb3VzZWxEb3duIn0sIndpZHRoIjo4MDAsImhlaWdodCI6NDAwfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6Mi43LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTNV9WSURFTyB9fSIsInZvbHVtZSI6MH0sInN0YXJ0Ijo3LCJ0cmFuc2l0aW9uIjp7Im91dCI6ImNhcm91c2VsRG93biIsImluIjoiY2Fyb3VzZWxSaWdodCJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjEwODMsImhlaWdodCI6MjA0Mywib2Zmc2V0Ijp7IngiOjAsInkiOjB9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTM19TdWJ0aXRsZX19IiwiZm9udCI6eyJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjEzMCwid2VpZ2h0Ijo4MDAsImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifSwiYW5pbWF0aW9uIjp7InByZXNldCI6ImZhZGVJbiIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjUuMzEsImxlbmd0aCI6Mi4zOSwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMjM3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxMZWZ0Iiwib3V0IjoiY2Fyb3VzZWxSaWdodCJ9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjQwMH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjIuNywiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzNfVklERU8gfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6NSwidHJhbnNpdGlvbiI6eyJvdXQiOiJjYXJvdXNlbFJpZ2h0IiwiaW4iOiJjYXJvdXNlbExlZnQifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDgzLCJoZWlnaHQiOjIwNDMsIm9mZnNldCI6eyJ4IjowLCJ5IjowfX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UzJfU3VidGl0bGV9fSIsImZvbnQiOnsiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjoxMzAsIndlaWdodCI6ODAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMSB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0IjozLjM2LCJsZW5ndGgiOjIuMzQsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjIzN30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImNhcm91c2VsVXAiLCJvdXQiOiJjYXJvdXNlbExlZnQifSwid2lkdGgiOjgwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoyLjcsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMyX1ZJREVPIH19Iiwidm9sdW1lIjowfSwic3RhcnQiOjMsInRyYW5zaXRpb24iOnsib3V0IjoiY2Fyb3VzZWxMZWZ0IiwiaW4iOiJjYXJvdXNlbFVwIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MTA4MywiaGVpZ2h0IjoyMDEwLCJvZmZzZXQiOnsieCI6MCwieSI6MH19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MxX1RpdGxlXzJ9fSIsImZvbnQiOnsiZmFtaWx5IjoiSG9saWRheUZyZWUiLCJzaXplIjoxMTAsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0IjowLCJsZW5ndGgiOjMuNywib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjIwOX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAiLCJvdXQiOiJjYXJvdXNlbFVwIn0sIndpZHRoIjo5MDAsImhlaWdodCI6MjAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTMV90aXRsZV8xfX0iLCJmb250Ijp7ImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6MTcwLCJ3ZWlnaHQiOjgwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAsImxlbmd0aCI6My43LCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMDk3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6ImNhcm91c2VsVXAiLCJpbiI6InNsaWRlVXAifSwid2lkdGgiOjgwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjozLjcsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMxX1ZJREVPIH19Iiwidm9sdW1lIjowfSwic3RhcnQiOjAsInRyYW5zaXRpb24iOnsib3V0IjoiY2Fyb3VzZWxVcCJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjEwODcsImhlaWdodCI6MjA1Mywib2Zmc2V0Ijp7IngiOjAsInkiOjB9fV19XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9LCJkZXN0aW5hdGlvbnMiOlt7InByb3ZpZGVyIjoic2hvdHN0YWNrIn1dfSwibWVyZ2UiOlt7ImZpbmQiOiJTMV90aXRsZV8xIiwicmVwbGFjZSI6IlNVTU1FUiJ9LHsiZmluZCI6IlMxX1RpdGxlXzIiLCJyZXBsYWNlIjoiSG9saWRheSBSZXZpZXcifSx7ImZpbmQiOiJTMV9WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vc3VtbWVyLWhvbGlkYXktcmVjYXAtcmV2aWV3LXN0b3J5LXRlbXBsYXRlLWhpZ2hsaWdodHMvN2U4OWMzNGUtMWRmMS00MTkyLTkyYmMtZjIxOGViYWE1NDQ0L3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTMl9TdWJ0aXRsZSIsInJlcGxhY2UiOiJCZWFjaCBEYXkifSx7ImZpbmQiOiJTMl9WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vc3VtbWVyLWhvbGlkYXktcmVjYXAtcmV2aWV3LXN0b3J5LXRlbXBsYXRlLWhpZ2hsaWdodHMvYTIwYTBjZDktOGFmMi00YjBjLTk5OTUtZGE4YzMyOWQ3MzUxL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTM19TdWJ0aXRsZSIsInJlcGxhY2UiOiJQaWNuaWMgaW4gdGhlIFBhcmsifSx7ImZpbmQiOiJTM19WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vc3VtbWVyLWhvbGlkYXktcmVjYXAtcmV2aWV3LXN0b3J5LXRlbXBsYXRlLWhpZ2hsaWdodHMvYWQ4NTlhYmQtODE5NS00YWQ1LWI3Y2UtZGU5YzRmOTBmZjgwL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTNF9TdWJ0aXRsZSIsInJlcGxhY2UiOiJSb2FkIFRyaXAifSx7ImZpbmQiOiJTNV9WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vc3VtbWVyLWhvbGlkYXktcmVjYXAtcmV2aWV3LXN0b3J5LXRlbXBsYXRlLWhpZ2hsaWdodHMvZThmY2MzMjUtZTk3MS00NDNiLTg4MWMtOWRhNWQ3YjBjZDNiL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTNl9TdWJ0aXRsZSIsInJlcGxhY2UiOiJDYW1waW5nIn0seyJmaW5kIjoiUzZfVklERU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3N1bW1lci1ob2xpZGF5LXJlY2FwLXJldmlldy1zdG9yeS10ZW1wbGF0ZS1oaWdobGlnaHRzLzU1YzMzMjFlLTI0ODctNDZiNy05ZGI2LTNiYmFkNTI4YzA0My9zb3VyY2UubXA0In0seyJmaW5kIjoiUzdfU3VidGl0bGVfMSIsInJlcGxhY2UiOiJNRU1PUklFUyJ9LHsiZmluZCI6IlM3X1N1YnRpdGxlXzIiLCJyZXBsYWNlIjoiTWFkZSBVbmRlciBTa2llcyJ9LHsiZmluZCI6IlM3X1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9zdW1tZXItaG9saWRheS1yZWNhcC1yZXZpZXctc3RvcnktdGVtcGxhdGUtaGlnaGxpZ2h0cy9iNDFmM2NlMy02MDM0LTQ1YjktYTFmZi1lYjNhZDQ3YzBhNzMvc291cmNlLm1wNCJ9LHsiZmluZCI6IkZPTlRfQ09MT1JfMSIsInJlcGxhY2UiOiIjZmZmZmZmIn0seyJmaW5kIjoiRk9OVF9DT0xPUl8yIiwicmVwbGFjZSI6IiMxMmMyMWYifSx7ImZpbmQiOiJBVURJTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vc3VtbWVyLWhvbGlkYXktcmVjYXAtcmV2aWV3LXN0b3J5LXRlbXBsYXRlLWhpZ2hsaWdodHMvZGUzMmI5YWMtN2IwZi00NjQ4LTgwYjktYWQ3OWRiNGNjZDc1L3NvdXJjZS5tcDMifV19 - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/summer-holiday-recap-review-story-template-highlights-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 }}` | SUMMER | | `{{ S1_Title_2 }}` | Holiday Review | | `{{ S1_VIDEO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/7e89c34e-1df1-4192-92bc-f218ebaa5444/source.mp4 | | `{{ S2_Subtitle }}` | Beach Day | | `{{ S2_VIDEO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/a20a0cd9-8af2-4b0c-9995-da8c329d7351/source.mp4 | | `{{ S3_Subtitle }}` | Picnic in the Park | | `{{ S3_VIDEO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/ad859abd-8195-4ad5-b7ce-de9c4f90ff80/source.mp4 | | `{{ S4_Subtitle }}` | Road Trip | | `{{ S5_VIDEO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/e8fcc325-e971-443b-881c-9da5d7b0cd3b/source.mp4 | | `{{ S6_Subtitle }}` | Camping | | `{{ S6_VIDEO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/55c3321e-2487-46b7-9db6-3bbad528c043/source.mp4 | | `{{ S7_Subtitle_1 }}` | MEMORIES | | `{{ S7_Subtitle_2 }}` | Made Under Skies | | `{{ S7_VIDEO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/b41f3ce3-6034-45b9-a1ff-eb3ad47c0a73/source.mp4 | | `{{ FONT_COLOR_1 }}` | #ffffff | | `{{ FONT_COLOR_2 }}` | #12c21f | | `{{ AUDIO }}` | https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/de32b9ac-7b0f-4648-80b9-ad79db4ccd75/source.mp3 | ## Template JSON ```json { "timeline": { "fonts": [ { "src": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/da851e89-b4d7-4744-b129-37a2645432a8/source.otf" } ], "background": "#FFFFFF", "tracks": [ { "clips": [ { "length": "end", "asset": { "type": "audio", "src": "{{ AUDIO }}", "volume": 1 }, "start": 0 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S7_Subtitle_2}}", "font": { "family": "HolidayFree", "size": 80, "weight": 400, "color": "{{ FONT_COLOR_2 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 11.57, "length": "end", "offset": { "x": 0, "y": -0.072 }, "position": "center", "transition": { "in": "carouselUp" }, "width": 900, "height": 200 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S7_Subtitle_1}}", "font": { "family": "Montserrat ExtraBold", "size": 130, "weight": 800, "color": "{{ FONT_COLOR_1 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 11.28, "length": "end", "position": "center", "transition": { "in": "carouselUp" }, "width": 800, "height": 400 } ] }, { "clips": [ { "length": 3.7, "asset": { "type": "video", "src": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/b41f3ce3-6034-45b9-a1ff-eb3ad47c0a73/source.mp4", "volume": 0 }, "start": 11, "transition": { "in": "carouselUp" }, "position": "center", "fit": "contain", "width": 1087, "height": 2053, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S6_Subtitle}}", "font": { "family": "Montserrat ExtraBold", "size": 130, "weight": 800, "color": "{{ FONT_COLOR_1 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 9.16, "length": 2.54, "offset": { "x": 0, "y": 0.237 }, "position": "center", "transition": { "out": "carouselUp", "in": "carouselDown" }, "width": 800, "height": 400 } ] }, { "clips": [ { "length": 2.7, "asset": { "type": "video", "src": "{{ S6_VIDEO }}", "volume": 0 }, "start": 9, "transition": { "in": "carouselDown", "out": "carouselUp" }, "fit": "contain", "width": 1087, "height": 2053, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S4_Subtitle}}", "font": { "family": "Montserrat ExtraBold", "size": 130, "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": 7.15, "length": 2.55, "offset": { "x": 0, "y": 0.237 }, "position": "center", "transition": { "in": "carouselRight", "out": "carouselDown" }, "width": 800, "height": 400 } ] }, { "clips": [ { "length": 2.7, "asset": { "type": "video", "src": "{{ S5_VIDEO }}", "volume": 0 }, "start": 7, "transition": { "out": "carouselDown", "in": "carouselRight" }, "fit": "contain", "width": 1083, "height": 2043, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S3_Subtitle}}", "font": { "family": "Montserrat ExtraBold", "size": 130, "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": 5.31, "length": 2.39, "offset": { "x": 0, "y": 0.237 }, "position": "center", "transition": { "in": "carouselLeft", "out": "carouselRight" }, "width": 800, "height": 400 } ] }, { "clips": [ { "length": 2.7, "asset": { "type": "video", "src": "{{ S3_VIDEO }}", "volume": 0 }, "start": 5, "transition": { "out": "carouselRight", "in": "carouselLeft" }, "fit": "contain", "width": 1083, "height": 2043, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S2_Subtitle}}", "font": { "family": "Montserrat ExtraBold", "size": 130, "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": 3.36, "length": 2.34, "offset": { "x": 0, "y": 0.237 }, "position": "center", "transition": { "in": "carouselUp", "out": "carouselLeft" }, "width": 800, "height": 200 } ] }, { "clips": [ { "length": 2.7, "asset": { "type": "video", "src": "{{ S2_VIDEO }}", "volume": 0 }, "start": 3, "transition": { "out": "carouselLeft", "in": "carouselUp" }, "fit": "contain", "width": 1083, "height": 2010, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S1_Title_2}}", "font": { "family": "HolidayFree", "size": 110, "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": 0, "length": 3.7, "offset": { "x": 0, "y": -0.209 }, "position": "center", "transition": { "in": "slideUp", "out": "carouselUp" }, "width": 900, "height": 200 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S1_title_1}}", "font": { "family": "Montserrat ExtraBold", "size": 170, "weight": 800, "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": 3.7, "offset": { "x": 0, "y": -0.097 }, "position": "center", "transition": { "out": "carouselUp", "in": "slideUp" }, "width": 800, "height": 200 } ] }, { "clips": [ { "length": 3.7, "asset": { "type": "video", "src": "{{ S1_VIDEO }}", "volume": 0 }, "start": 0, "transition": { "out": "carouselUp" }, "fit": "contain", "width": 1087, "height": 2053, "offset": { "x": 0, "y": 0 } } ] } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 }, "destinations": [ { "provider": "shotstack" } ] }, "merge": [ { "find": "S1_title_1", "replace": "SUMMER" }, { "find": "S1_Title_2", "replace": "Holiday Review" }, { "find": "S1_VIDEO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/7e89c34e-1df1-4192-92bc-f218ebaa5444/source.mp4" }, { "find": "S2_Subtitle", "replace": "Beach Day" }, { "find": "S2_VIDEO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/a20a0cd9-8af2-4b0c-9995-da8c329d7351/source.mp4" }, { "find": "S3_Subtitle", "replace": "Picnic in the Park" }, { "find": "S3_VIDEO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/ad859abd-8195-4ad5-b7ce-de9c4f90ff80/source.mp4" }, { "find": "S4_Subtitle", "replace": "Road Trip" }, { "find": "S5_VIDEO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/e8fcc325-e971-443b-881c-9da5d7b0cd3b/source.mp4" }, { "find": "S6_Subtitle", "replace": "Camping" }, { "find": "S6_VIDEO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/55c3321e-2487-46b7-9db6-3bbad528c043/source.mp4" }, { "find": "S7_Subtitle_1", "replace": "MEMORIES" }, { "find": "S7_Subtitle_2", "replace": "Made Under Skies" }, { "find": "S7_VIDEO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/b41f3ce3-6034-45b9-a1ff-eb3ad47c0a73/source.mp4" }, { "find": "FONT_COLOR_1", "replace": "#ffffff" }, { "find": "FONT_COLOR_2", "replace": "#12c21f" }, { "find": "AUDIO", "replace": "https://templates.shotstack.io/summer-holiday-recap-review-story-template-highlights/de32b9ac-7b0f-4648-80b9-ad79db4ccd75/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