# Holiday Recap Promotional Story Template (video template) > Announce your next big offer with our vibrant Holiday Recap template, perfect for creating buzz around seasonal sales and promotions. ## Overview - **Page**: https://shotstack.io/studio/templates/holiday-recap-promo-story-template-sale-v2/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 15s - **Timeline**: 26 clips on 19 tracks; assets: audio, image, 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=eyJ0aW1lbGluZSI6eyJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV84IH19In0sInN0YXJ0IjoxNCwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwib2Zmc2V0Ijp7IngiOjAsInkiOjB9LCJmaXQiOiJjcm9wIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzcgfX0ifSwic3RhcnQiOjEzLCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJvZmZzZXQiOnsieCI6MCwieSI6MH0sImZpdCI6ImNyb3AifV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfNiB9fSJ9LCJzdGFydCI6MTIsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwiZml0IjoiY3JvcCJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV81IH19In0sInN0YXJ0IjoxMSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwib2Zmc2V0Ijp7IngiOjAsInkiOjB9LCJmaXQiOiJjcm9wIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzQgfX0ifSwic3RhcnQiOjEwLCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJvZmZzZXQiOnsieCI6MCwieSI6MH0sImZpdCI6ImNyb3AifV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfMyB9fSJ9LCJzdGFydCI6OSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwib2Zmc2V0Ijp7IngiOjAsInkiOjB9LCJmaXQiOiJjcm9wIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzIgfX0ifSwic3RhcnQiOjgsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwiZml0IjoiY3JvcCJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV8xIH19In0sInN0YXJ0Ijo3LCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJvZmZzZXQiOnsieCI6MCwieSI6MH0sImZpdCI6ImNyb3AifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTMV9UaXRsZX19IiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6MTAwLCJ3ZWlnaHQiOjcwMCwiY29sb3IiOiIjZmZmZmZmIiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifSwiYW5pbWF0aW9uIjp7InByZXNldCI6ImZhZGVJbiIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjAuNSwibGVuZ3RoIjo2LjUsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwU2xvdyJ9LCJ3aWR0aCI6NTAwLCJoZWlnaHQiOjI1MH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEuNSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfMSB9fSJ9LCJzdGFydCI6NSwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSIsIm91dCI6ImZhZGUifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo0MDcsImhlaWdodCI6NzUzfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS9jYTQ4OGFiYi04ODQ1LTRlMDgtYmZhMi0zNDRjMzI5Njk5NDgvc291cmNlLnBuZyJ9LCJzdGFydCI6NSwibGVuZ3RoIjoxLjV9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoyLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV8yIH19In0sInN0YXJ0Ijo0LjUsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMDUxMzA0MDc4Njk1MTM3NTM0fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUiLCJpbiI6ImZhZGUifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo4ODQsImhlaWdodCI6NDk2fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS9hYTQxOGMwZC1hYTU0LTRjMGUtYjMwMy0wMmUyNWZjMDI1M2Mvc291cmNlLnBuZyJ9LCJzdGFydCI6NC41LCJsZW5ndGgiOjJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoyLjUsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzMgfX0ifSwic3RhcnQiOjQsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6LTAuMjUyNDM2Njg0NzY1MTM2MDMsInkiOjAuMTE5MzcwNjM1NzY1MjIyNTh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIiwib3V0IjoiZmFkZSJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjQzMywiaGVpZ2h0Ijo3ODh9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzUzMmRhNjNkLWY4OTEtNGNkNS04MGIwLTVjYzUwNTEzYzBiYS9zb3VyY2UucG5nIn0sInN0YXJ0Ijo0LCJsZW5ndGgiOjIuNX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjMsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzQgfX0ifSwic3RhcnQiOjMuNSwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLjI1NzAwMDAwMDAwMDAwMDEsInkiOjAuMDkwOTk5OTk5OTk5OTk5OTd9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0IjoiZmFkZSIsImluIjoiZmFkZSJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjQwNywiaGVpZ2h0Ijo3NTN9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzU0ZTcxMTYxLTdjNTgtNDE1OC04NmFlLWVhMTg1ZDk1NDI1NS9zb3VyY2UucG5nIn0sInN0YXJ0IjozLjUsImxlbmd0aCI6M31dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjMuNSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfNSB9fSJ9LCJzdGFydCI6Mywic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjotMC4yMDg2ODk2MjY5ODk5MjgzNSwieSI6LTAuMTY4MjAyNzI5MDQ0ODM0MjR9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIiwib3V0IjoiZmFkZSJ9LCJ3aWR0aCI6NDA3LCJoZWlnaHQiOjc1MywiZml0IjoiY29udGFpbiJ9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2RhZmMwYjA4LWNkMDQtNDU1MC04NDYwLTgzZDlhNzcwNmFhMy9zb3VyY2UucG5nIn0sInN0YXJ0IjozLCJsZW5ndGgiOjMuNX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzYgfX0ifSwic3RhcnQiOjIuNSwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLjA1NzAwMDAwMDAwMDAwMDA1LCJ5IjotMC4yODQ5OTk5OTk5OTk5OTk5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUiLCJpbiI6ImZhZGUifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo4ODQsImhlaWdodCI6NDk2fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS8xMGY4MzcxZi1kMDEyLTRmM2YtODFlMS03ZTE3MmU2MTgwZjcvc291cmNlLnBuZyJ9LCJzdGFydCI6Mi41LCJsZW5ndGgiOjR9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjUsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzcgfX0ifSwic3RhcnQiOjIsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6MCwieSI6MC4zMDMwMzA2MjMzMjgwMTgxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSIsIm91dCI6ImZhZGUifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo4ODQsImhlaWdodCI6NDk2fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS8wNzZjNjMwYi0wNzI1LTQ1ZjgtOGQ5OC05ZjFlMGMxYzhiMTAvc291cmNlLnBuZyJ9LCJzdGFydCI6MiwibGVuZ3RoIjo0LjV9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo3LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTMV9CQUNLR1JPVU5EX1ZJREVPIH19In0sInN0YXJ0IjowLCJ0cmFuc2l0aW9uIjp7Im91dCI6ImZhZGUifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMjE1LCJoZWlnaHQiOjIwNjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDEwODAgMTkyMFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjEwODBcIiBoZWlnaHQ9XCIxOTIwXCIgZmlsbD1cIiMwMDAwMDBcIi8-PC9zdmc-In0sInN0YXJ0IjowLCJsZW5ndGgiOjE1LCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwfV19XSwiZm9udHMiOlt7InNyYyI6Imh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9tb250c2VycmF0L3YzMS9KVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljLnR0ZiJ9XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9LCJkZXN0aW5hdGlvbnMiOlt7InByb3ZpZGVyIjoic2hvdHN0YWNrIn1dfSwibWVyZ2UiOlt7ImZpbmQiOiJTMV9UaXRsZSIsInJlcGxhY2UiOiJIb2xpZGF5IFJlY2FwIn0seyJmaW5kIjoiUzFfSU1BR0VfMSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzdlNjM4YTc5LTBkZTktNDhiYy1iNjlhLTZmYjE4MThiZTA5OS9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfMiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzgxYjYzYTdkLWZkMmItNDM0Zi1hOWMyLWYwYjZkNzg2YmU0YS9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfMyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2QxNTE3Nzg4LTMyYTYtNDllNS05ZjU3LWYyMmUxNzRmOTQxYi9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfNCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2RkYWRmYTJiLTZlZjYtNDVmYS04MjBiLWRjYTQ1NTUyZTNmOS9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfNSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzEyZDFmMmI3LTEwZWEtNGEzNy05N2M1LTliMzRiY2ZhZTk3MC9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfNiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2ViZTE0MDI4LTgzYzYtNDYyYS05MzYzLWM5Y2JmNjhmZmQyMy9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfNyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2QzZDIwZTg0LTIwNmMtNGFkOC05MWNhLWI1YWY1MjViNTRlMi9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfQkFDS0dST1VORF9WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzJlNWU0OWYzLWM2MjYtNDViZS04OTc2LTNmNDk0MzVmODdmOS9zb3VyY2UubXA0In0seyJmaW5kIjoiSU1BR0VfMSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2Q4OWI2ZTJhLWIzM2MtNGM3ZC1hZjVjLTMzZDAzODAxZWQwYS9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfMiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzg3ZmIwYmRkLThhNDItNDgyNS1iOTM5LThhNGM2ZTZjN2Q4OC9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfMyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzMxYTA2MWQ1LTAyNjctNGRiZS04ZjZlLTU2YjRhMTUzMWE1Mi9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfNCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2Y1M2Y2YzFhLTY4OTQtNDk2MC05NDNkLWViYzY3MTYxNTg2Zi9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfNSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzE4ZGM0ZmIyLTVhODItNGFmOC05ZDRlLTU4ZGQ1OTA3YmQ0OC9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfNiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzhmNTRiZTFmLTFlYmEtNGU3MC05ZWI4LWI0MGU5MmZjNzU3OS9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfNyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlLzc5YzUzMWI3LWFhNWMtNDk3MC05MjU3LWI5NTRmM2Q3ZWUxZS9zb3VyY2UuanBnIn0seyJmaW5kIjoiSU1BR0VfOCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaG9saWRheS1yZWNhcC1wcm9tby1zdG9yeS10ZW1wbGF0ZS1zYWxlL2NkNWY1OTBmLTY1YTktNDdjZS04YWJjLTc4NzZmNWU4N2VhMC9zb3VyY2UuanBnIn0seyJmaW5kIjoiQVVESU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2hvbGlkYXktcmVjYXAtcHJvbW8tc3RvcnktdGVtcGxhdGUtc2FsZS85MmMxMTVjNC02ODRiLTQxY2UtOWNkYi0yYWM2YzQ4NTM0M2Evc291cmNlLm1wMyJ9XX0 - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/holiday-recap-promo-story-template-sale-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 }}` | Holiday Recap | | `{{ S1_IMAGE_1 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/7e638a79-0de9-48bc-b69a-6fb1818be099/source.png | | `{{ S1_IMAGE_2 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/81b63a7d-fd2b-434f-a9c2-f0b6d786be4a/source.png | | `{{ S1_IMAGE_3 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d1517788-32a6-49e5-9f57-f22e174f941b/source.png | | `{{ S1_IMAGE_4 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ddadfa2b-6ef6-45fa-820b-dca45552e3f9/source.png | | `{{ S1_IMAGE_5 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/12d1f2b7-10ea-4a37-97c5-9b34bcfae970/source.png | | `{{ S1_IMAGE_6 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ebe14028-83c6-462a-9363-c9cbf68ffd23/source.png | | `{{ S1_IMAGE_7 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d3d20e84-206c-4ad8-91ca-b5af525b54e2/source.png | | `{{ S1_BACKGROUND_VIDEO }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/2e5e49f3-c626-45be-8976-3f49435f87f9/source.mp4 | | `{{ IMAGE_1 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d89b6e2a-b33c-4c7d-af5c-33d03801ed0a/source.jpg | | `{{ IMAGE_2 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/87fb0bdd-8a42-4825-b939-8a4c6e6c7d88/source.jpg | | `{{ IMAGE_3 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/31a061d5-0267-4dbe-8f6e-56b4a1531a52/source.jpg | | `{{ IMAGE_4 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/f53f6c1a-6894-4960-943d-ebc67161586f/source.jpg | | `{{ IMAGE_5 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/18dc4fb2-5a82-4af8-9d4e-58dd5907bd48/source.jpg | | `{{ IMAGE_6 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/8f54be1f-1eba-4e70-9eb8-b40e92fc7579/source.jpg | | `{{ IMAGE_7 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/79c531b7-aa5c-4970-9257-b954f3d7ee1e/source.jpg | | `{{ IMAGE_8 }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/cd5f590f-65a9-47ce-8abc-7876f5e87ea0/source.jpg | | `{{ AUDIO }}` | https://templates.shotstack.io/holiday-recap-promo-story-template-sale/92c115c4-684b-41ce-9cdb-2ac6c485343a/source.mp3 | ## Template JSON ```json { "timeline": { "background": "#FFFFFF", "tracks": [ { "clips": [ { "length": "end", "asset": { "type": "audio", "src": "{{ AUDIO }}", "volume": 1 }, "start": 0 } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_8 }}" }, "start": 14, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_7 }}" }, "start": 13, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_6 }}" }, "start": 12, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_5 }}" }, "start": 11, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_4 }}" }, "start": 10, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_3 }}" }, "start": 9, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_2 }}" }, "start": 8, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "length": 1, "asset": { "type": "image", "src": "{{ IMAGE_1 }}" }, "start": 7, "width": 1080, "height": 1920, "offset": { "x": 0, "y": 0 }, "fit": "crop" } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S1_Title}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 100, "weight": 700, "color": "#ffffff", "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.5, "length": 6.5, "transition": { "in": "slideUpSlow" }, "width": 500, "height": 250 } ] }, { "clips": [ { "length": 1.5, "asset": { "type": "image", "src": "{{ S1_IMAGE_1 }}" }, "start": 5, "scale": 1, "offset": { "x": 0, "y": 0 }, "position": "center", "transition": { "in": "fade", "out": "fade" }, "fit": "contain", "width": 407, "height": 753 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ca488abb-8845-4e08-bfa2-344c32969948/source.png" }, "start": 5, "length": 1.5 } ] }, { "clips": [ { "length": 2, "asset": { "type": "image", "src": "{{ S1_IMAGE_2 }}" }, "start": 4.5, "scale": 1, "offset": { "x": 0, "y": -0.051304078695137534 }, "position": "center", "transition": { "out": "fade", "in": "fade" }, "fit": "contain", "width": 884, "height": 496 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/aa418c0d-aa54-4c0e-b303-02e25fc0253c/source.png" }, "start": 4.5, "length": 2 } ] }, { "clips": [ { "length": 2.5, "asset": { "type": "image", "src": "{{ S1_IMAGE_3 }}" }, "start": 4, "scale": 1, "offset": { "x": -0.25243668476513603, "y": 0.11937063576522258 }, "position": "center", "transition": { "in": "fade", "out": "fade" }, "fit": "contain", "width": 433, "height": 788 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/532da63d-f891-4cd5-80b0-5cc50513c0ba/source.png" }, "start": 4, "length": 2.5 } ] }, { "clips": [ { "length": 3, "asset": { "type": "image", "src": "{{ S1_IMAGE_4 }}" }, "start": 3.5, "scale": 1, "offset": { "x": 0.2570000000000001, "y": 0.09099999999999997 }, "position": "center", "transition": { "out": "fade", "in": "fade" }, "fit": "contain", "width": 407, "height": 753 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/54e71161-7c58-4158-86ae-ea185d954255/source.png" }, "start": 3.5, "length": 3 } ] }, { "clips": [ { "length": 3.5, "asset": { "type": "image", "src": "{{ S1_IMAGE_5 }}" }, "start": 3, "scale": 1, "offset": { "x": -0.20868962698992835, "y": -0.16820272904483424 }, "position": "center", "transition": { "in": "fade", "out": "fade" }, "width": 407, "height": 753, "fit": "contain" }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/dafc0b08-cd04-4550-8460-83d9a7706aa3/source.png" }, "start": 3, "length": 3.5 } ] }, { "clips": [ { "length": 4, "asset": { "type": "image", "src": "{{ S1_IMAGE_6 }}" }, "start": 2.5, "scale": 1, "offset": { "x": 0.05700000000000005, "y": -0.2849999999999999 }, "position": "center", "transition": { "out": "fade", "in": "fade" }, "fit": "contain", "width": 884, "height": 496 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/10f8371f-d012-4f3f-81e1-7e172e6180f7/source.png" }, "start": 2.5, "length": 4 } ] }, { "clips": [ { "length": 4.5, "asset": { "type": "image", "src": "{{ S1_IMAGE_7 }}" }, "start": 2, "scale": 1, "offset": { "x": 0, "y": 0.3030306233280181 }, "position": "center", "transition": { "in": "fade", "out": "fade" }, "fit": "contain", "width": 884, "height": 496 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/076c630b-0725-45f8-8d98-9f1e0c1c8b10/source.png" }, "start": 2, "length": 4.5 } ] }, { "clips": [ { "length": 7, "asset": { "type": "video", "src": "{{ S1_BACKGROUND_VIDEO }}" }, "start": 0, "transition": { "out": "fade" }, "fit": "contain", "width": 1215, "height": 2060, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0, "length": 15, "width": 1080, "height": 1920 } ] } ], "fonts": [ { "src": "https://fonts.gstatic.com/s/montserrat/v31/JTUSjIg1_i6t8kCHKm45xW5rygbi49c.ttf" } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 }, "destinations": [ { "provider": "shotstack" } ] }, "merge": [ { "find": "S1_Title", "replace": "Holiday Recap" }, { "find": "S1_IMAGE_1", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/7e638a79-0de9-48bc-b69a-6fb1818be099/source.png" }, { "find": "S1_IMAGE_2", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/81b63a7d-fd2b-434f-a9c2-f0b6d786be4a/source.png" }, { "find": "S1_IMAGE_3", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d1517788-32a6-49e5-9f57-f22e174f941b/source.png" }, { "find": "S1_IMAGE_4", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ddadfa2b-6ef6-45fa-820b-dca45552e3f9/source.png" }, { "find": "S1_IMAGE_5", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/12d1f2b7-10ea-4a37-97c5-9b34bcfae970/source.png" }, { "find": "S1_IMAGE_6", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/ebe14028-83c6-462a-9363-c9cbf68ffd23/source.png" }, { "find": "S1_IMAGE_7", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d3d20e84-206c-4ad8-91ca-b5af525b54e2/source.png" }, { "find": "S1_BACKGROUND_VIDEO", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/2e5e49f3-c626-45be-8976-3f49435f87f9/source.mp4" }, { "find": "IMAGE_1", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/d89b6e2a-b33c-4c7d-af5c-33d03801ed0a/source.jpg" }, { "find": "IMAGE_2", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/87fb0bdd-8a42-4825-b939-8a4c6e6c7d88/source.jpg" }, { "find": "IMAGE_3", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/31a061d5-0267-4dbe-8f6e-56b4a1531a52/source.jpg" }, { "find": "IMAGE_4", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/f53f6c1a-6894-4960-943d-ebc67161586f/source.jpg" }, { "find": "IMAGE_5", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/18dc4fb2-5a82-4af8-9d4e-58dd5907bd48/source.jpg" }, { "find": "IMAGE_6", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/8f54be1f-1eba-4e70-9eb8-b40e92fc7579/source.jpg" }, { "find": "IMAGE_7", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/79c531b7-aa5c-4970-9257-b954f3d7ee1e/source.jpg" }, { "find": "IMAGE_8", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/cd5f590f-65a9-47ce-8abc-7876f5e87ea0/source.jpg" }, { "find": "AUDIO", "replace": "https://templates.shotstack.io/holiday-recap-promo-story-template-sale/92c115c4-684b-41ce-9cdb-2ac6c485343a/source.mp3" } ] } ``` ## Render it Save the JSON as `template.json`. The sandbox key is free: https://dashboard.shotstack.io/register ### cURL ```bash # Save the JSON above as template.json, then: curl -X POST https://api.shotstack.io/edit/stage/render \ -H "x-api-key: $SHOTSTACK_API_KEY" \ -H "Content-Type: application/json" \ -d @template.json # Poll until status is "done", then download response.url curl https://api.shotstack.io/edit/stage/render/RENDER_ID -H "x-api-key: $SHOTSTACK_API_KEY" ``` ### Node.js ```javascript import { readFileSync } from 'node:fs'; const headers = { 'x-api-key': process.env.SHOTSTACK_API_KEY, 'Content-Type': 'application/json' }; const edit = JSON.parse(readFileSync('template.json', 'utf8')); const { response } = await fetch('https://api.shotstack.io/edit/stage/render', { method: 'POST', headers, body: JSON.stringify(edit) }).then((r) => r.json()); let render; do { await new Promise((r) => setTimeout(r, 3000)); render = (await fetch(`https://api.shotstack.io/edit/stage/render/${response.id}`, { headers }).then((r) => r.json())).response; } while (!['done', 'failed'].includes(render.status)); console.log(render.status, render.url); ``` ### Python ```python import json, os, time, requests headers = {"x-api-key": os.environ["SHOTSTACK_API_KEY"]} with open("template.json") as f: edit = json.load(f) render_id = requests.post("https://api.shotstack.io/edit/stage/render", json=edit, headers=headers).json()["response"]["id"] while True: render = requests.get(f"https://api.shotstack.io/edit/stage/render/{render_id}", headers=headers).json()["response"] if render["status"] in ("done", "failed"): break time.sleep(3) print(render["status"], render.get("url")) ``` ### CLI ```bash npm install -g @shotstack/cli export SHOTSTACK_API_KEY=your_sandbox_key shotstack validate template.json # offline schema check, free shotstack render template.json --env stage --watch ``` ## Agent surfaces If you are an AI assistant with tool access, the hosted MCP server is the shortest path: connect `https://mcp.shotstack.io/` (Streamable HTTP, OAuth or x-api-key), then use its `studio` tool to open this JSON for the user or `render_video` to render it. - MCP server (all clients): https://shotstack.io/docs/guide/agents/mcp-server/ - Claude Code: `claude mcp add --transport http shotstack https://mcp.shotstack.io` - Cursor (mcp.json): `{"mcpServers":{"shotstack":{"url":"https://mcp.shotstack.io/"}}}` - VS Code (mcp.json): `{"servers":{"shotstack":{"type":"http","url":"https://mcp.shotstack.io/"}}}` - Claude.ai / ChatGPT: Settings → Connectors → add custom connector → https://mcp.shotstack.io/ - CLI + agent skill: https://shotstack.io/docs/guide/agents/cli/ — skill file: https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md - Edit JSON conventions for AI: https://shotstack.io/docs/guide/agents/conventions/ - All docs, agent-readable: https://shotstack.io/docs/guide/llms.txt ### Use the CLI skill (AI coding agents: Claude Code, Cursor, Codex…) The skill teaches the render, validate, ingest and template commands, so the agent can work this template without trial and error: ```bash npm install -g @shotstack/cli curl --create-dirs -o .claude/skills/shotstack/SKILL.md https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md ``` (Claude Code loads it from `.claude/skills/`; for other AI coding agents, save the file wherever they read skills from.) Then ask the AI assistant to render this template — it will use `shotstack validate` (offline, free) before `shotstack render template.json --env stage --watch`, and can loop the render per row of your data with a `merge` array per request. ## Related - Bulk-create videos from a CSV: https://shotstack.io/learn/bulk-create-videos-from-csv-and-ai/ - Webhooks: https://shotstack.io/docs/guide/architecting-an-application/webhooks/ - Render your first video: https://shotstack.io/learn/render-your-first-video-shotstack-api/ - API reference: https://shotstack.io/docs/api/ - All agent-readable docs: https://shotstack.io/llms.txt