# Chic Grid Sale & Offer Announcement Template (video template)

> Promote your next big sale with this stylish, easy-to-edit grid template. Perfect for fashion, retail, and seasonal offers.

## Overview

- **Page**: https://shotstack.io/studio/templates/modern-sale-promo-grid-template/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 9s
- **Timeline**: 24 clips on 24 tracks; assets: audio, image, text
- **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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL21vZGVybi1zYWxlLXByb21vLWdyaWQtdGVtcGxhdGUvOTU0NWM1NmUtNTY4Mi00NjNmLWI1NTItZTM5ZWY2YWM3ZTJhL3NvdXJjZS50dGYifSx7InNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9tb2Rlcm4tc2FsZS1wcm9tby1ncmlkLXRlbXBsYXRlL2JkNTIzMjVkLTcxMWQtNGNmZS1hYzlkLWYwMjE4ZTk0ZGI5Zi9zb3VyY2UudHRmIn0seyJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbW9kZXJuLXNhbGUtcHJvbW8tZ3JpZC10ZW1wbGF0ZS84M2IyNDQ0Zi0wZGQ3LTQyNTAtOTg5ZS01YTQwN2ZlNmI1OGMvc291cmNlLnR0ZiJ9XSwiYmFja2dyb3VuZCI6IiNGRkZGRkYiLCJ0cmFja3MiOlt7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiYXVkaW8iLCJzcmMiOiJ7eyBBVURJT19TUkMgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MyX2hhbmRsZX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik9zd2FsZCIsInNpemUiOiI3MCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NzAwLCJoZWlnaHQiOjcyfSwic3RhcnQiOjUuMjcsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4zNDJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZURvd24ifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MyX0NUQX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ikdpc3Rlc3kiLCJzaXplIjoiMTgwIiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MDAsImhlaWdodCI6MzAwfSwic3RhcnQiOjQuOSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjE2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMyX0lNQUdFXzExIH19In0sInN0YXJ0Ijo0LjYyLCJzY2FsZSI6MC40NSwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifSwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTk5fSwicG9zaXRpb24iOiJjZW50ZXIifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UzFfRGlzY291bnR9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJPc3dhbGQiLCJzaXplIjoiOTAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjMwMCwiaGVpZ2h0IjozMDB9LCJzdGFydCI6MC45LCJsZW5ndGgiOjQsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4xNzl9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVSaWdodCIsImluIjoic2xpZGVEb3duIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMV9TdWJfVGl0bGVfMX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik9zd2FsZCIsInNpemUiOiI5MCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MzAwLCJoZWlnaHQiOjMwMH0sInN0YXJ0IjowLjQsImxlbmd0aCI6NCwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NCwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfNyB9fSJ9LCJzdGFydCI6MSwic2NhbGUiOjAuMTMsIm9mZnNldCI6eyJ4IjowLjMxLCJ5IjotMC4xOTF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVSaWdodCIsImluIjoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6Mjg1LCJoZWlnaHQiOjI4NSwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjoxLCJsZW5ndGgiOjQsIm9mZnNldCI6eyJ4IjowLjMxLCJ5IjotMC4xOTF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NCwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfNiB9fSJ9LCJzdGFydCI6MC44LCJzY2FsZSI6MC4xMywib2Zmc2V0Ijp7IngiOi0wLjMxNiwieSI6LTAuMTl9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6Mjg1LCJoZWlnaHQiOjI4NSwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLjgsImxlbmd0aCI6NCwib2Zmc2V0Ijp7IngiOi0wLjMxNiwieSI6LTAuMTkxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlUmlnaHQiLCJpbiI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzEwIH19In0sInN0YXJ0IjoxLjMsInNjYWxlIjowLjE1LCJvZmZzZXQiOnsieCI6MC4zMSwieSI6LTAuMzU5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjMuOTksImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzggfX0ifSwic3RhcnQiOjEuMSwic2NhbGUiOjAuMTUsIm9mZnNldCI6eyJ4IjotMC4zMTYsInkiOi0wLjM2Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZVJpZ2h0IiwiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBTMV9JTUFHRV85IH19In0sInN0YXJ0IjoxLjIsInNjYWxlIjowLjEzLCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMzU5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjI4NSwiaGVpZ2h0IjoyODUsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19In19LCJzdGFydCI6MS4yLCJsZW5ndGgiOjQsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4zNTh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVSaWdodCIsImluIjoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NCwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfNSB9fSJ9LCJzdGFydCI6MC41LCJzY2FsZSI6MC4xNSwib2Zmc2V0Ijp7IngiOjAuMzEsInkiOjAuMTk5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzQgfX0ifSwic3RhcnQiOjAuMywic2NhbGUiOjAuMTUsIm9mZnNldCI6eyJ4IjotMC4zMTYsInkiOjAuMTk5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlUmlnaHQiLCJpbiI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzMgfX0ifSwic3RhcnQiOjAuMiwic2NhbGUiOjAuMTMsIm9mZnNldCI6eyJ4IjowLjMxLCJ5IjowLjM2Nn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjoyODUsImhlaWdodCI6Mjg1LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSJ9fSwic3RhcnQiOjAuMiwibGVuZ3RoIjo0LCJvZmZzZXQiOnsieCI6MC4zMSwieSI6MC4zNjh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVSaWdodCIsImluIjoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NCwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgUzFfSU1BR0VfMiB9fSJ9LCJzdGFydCI6MC4xLCJzY2FsZSI6MC4xNSwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMzY4fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMxX0lNQUdFXzEgfX0ifSwic3RhcnQiOjAsInNjYWxlIjowLjEzLCJvZmZzZXQiOnsieCI6LTAuMzE2LCJ5IjowLjM2OH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZVJpZ2h0IiwiaW4iOiJzbGlkZVJpZ2h0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjoyODUsImhlaWdodCI6Mjg1LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSJ9fSwic3RhcnQiOjAsImxlbmd0aCI6NCwib2Zmc2V0Ijp7IngiOi0wLjMxNiwieSI6MC4zNjh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UzFfVGl0bGVfMn19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik9zd2FsZCIsInNpemUiOiIxNTAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjcwMCwiaGVpZ2h0IjozMDB9LCJzdGFydCI6MC43LCJsZW5ndGgiOjQsIm9wYWNpdHkiOjEsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4wNTF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVVcCIsImluIjoic2xpZGVEb3duIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMV9UaXRsZV8xfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiR2lzdGVzeSIsInNpemUiOiIxNTAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjkwMCwiaGVpZ2h0IjoyNTB9LCJzdGFydCI6MC42LCJsZW5ndGgiOjQsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjA1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVEb3duIiwib3V0Ijoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgQkFDS0dST1VORF9DT0xPUiB9fSJ9fSwic3RhcnQiOjAsImxlbmd0aCI6OSwicG9zaXRpb24iOiJjZW50ZXIifV19XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9fSwibWVyZ2UiOlt7ImZpbmQiOiJTMV9JTUFHRV8xIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9tb2Rlcm4tc2FsZS1wcm9tby1ncmlkLXRlbXBsYXRlLzlhZWFiZmQ5LTcxYWQtNDUxMy04OGU1LTYyZDg0NThmYjllMS9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfMiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbW9kZXJuLXNhbGUtcHJvbW8tZ3JpZC10ZW1wbGF0ZS82YTY5Y2ZjOC1lODcyLTQyOTUtYmQzMC03MGQ3MWQ3YTY2OWYvc291cmNlLnBuZyJ9LHsiZmluZCI6IlMxX0lNQUdFXzMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL21vZGVybi1zYWxlLXByb21vLWdyaWQtdGVtcGxhdGUvODcxNzk2ZDMtOTQzYi00ZTE0LThhMDktNWZjM2FiZjc5Mzg5L3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV80IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9tb2Rlcm4tc2FsZS1wcm9tby1ncmlkLXRlbXBsYXRlL2Y4MDhlMDY3LTViYTgtNDljNC05MjFiLWVmMTU4YjVhYjA3Ny9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfNSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbW9kZXJuLXNhbGUtcHJvbW8tZ3JpZC10ZW1wbGF0ZS9mNWJhMDVlZS1hYzE1LTRhNWEtOGQ0Yi1mYmE4NjFhY2E3OTYvc291cmNlLnBuZyJ9LHsiZmluZCI6IlMxX0lNQUdFXzYiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL21vZGVybi1zYWxlLXByb21vLWdyaWQtdGVtcGxhdGUvMDBmZTZlMGItNzBhNi00NmUwLWJhN2YtZWY4M2FhZTkxNTc4L3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV83IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9tb2Rlcm4tc2FsZS1wcm9tby1ncmlkLXRlbXBsYXRlLzZlYzAxNzcwLWIwZDYtNDFlMi04NWMxLTVkN2Q5NmRmNmFlOC9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzFfSU1BR0VfOCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbW9kZXJuLXNhbGUtcHJvbW8tZ3JpZC10ZW1wbGF0ZS9mNjBiY2FlZi1hOGYyLTRjOTgtOGZiYS1kMWVjZTIyNTc0NzMvc291cmNlLnBuZyJ9LHsiZmluZCI6IlMxX0lNQUdFXzkiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL21vZGVybi1zYWxlLXByb21vLWdyaWQtdGVtcGxhdGUvOGFiYWI1N2UtZTMxYi00YWJkLWEwYzctNGI0NjBlMWY3Y2UxL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJTMV9JTUFHRV8xMCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbW9kZXJuLXNhbGUtcHJvbW8tZ3JpZC10ZW1wbGF0ZS85NDlhZTE2Ni01MDVhLTQwZjEtYTljZS1lNmQ1ZjY3ZTc2OWYvc291cmNlLnBuZyJ9LHsiZmluZCI6IlMxX1N1Yl9UaXRsZV8xIiwicmVwbGFjZSI6IlFVSUNLIERFQUwifSx7ImZpbmQiOiJTMV9UaXRsZV8yIiwicmVwbGFjZSI6IlNBTEVTIn0seyJmaW5kIjoiUzFfRGlzY291bnQiLCJyZXBsYWNlIjoiMzAlIE9GRiJ9LHsiZmluZCI6IkZPTlRfQ09MT1IiLCJyZXBsYWNlIjoiI2ZmZmZmZiJ9LHsiZmluZCI6IkJBQ0tHUk9VTkRfQ09MT1IiLCJyZXBsYWNlIjoiIzUyNGY0YyJ9LHsiZmluZCI6IlMyX0lNQUdFXzExIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9tb2Rlcm4tc2FsZS1wcm9tby1ncmlkLXRlbXBsYXRlL2M1OWFkMWQ2LTUyYjItNGVlNi1iM2I3LTlmZTc3YTkwMzBhMS9zb3VyY2UucG5nIn0seyJmaW5kIjoiUzJfQ1RBIiwicmVwbGFjZSI6IlNob3Agd2l0aCB1cyJ9LHsiZmluZCI6IlMyX2hhbmRsZSIsInJlcGxhY2UiOiJAIGZhem1vZGVsIn0seyJmaW5kIjoiQVVESU9fU1JDIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9tb2Rlcm4tc2FsZS1wcm9tby1ncmlkLXRlbXBsYXRlL2RmMzFlMmEyLTM1NDMtNDg2Mi05MmE2LTdhYzk4YzEwZmIwNS9zb3VyY2UubXAzIn0seyJmaW5kIjoiUzFfVGl0bGVfMSIsInJlcGxhY2UiOiJTdW1tZXIgSG9saWRheSJ9XX0
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/modern-sale-promo-grid-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_IMAGE_1 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/9aeabfd9-71ad-4513-88e5-62d8458fb9e1/source.png |
| `{{ S1_IMAGE_2 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/6a69cfc8-e872-4295-bd30-70d71d7a669f/source.png |
| `{{ S1_IMAGE_3 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/871796d3-943b-4e14-8a09-5fc3abf79389/source.png |
| `{{ S1_IMAGE_4 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/f808e067-5ba8-49c4-921b-ef158b5ab077/source.png |
| `{{ S1_IMAGE_5 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/f5ba05ee-ac15-4a5a-8d4b-fba861aca796/source.png |
| `{{ S1_IMAGE_6 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/00fe6e0b-70a6-46e0-ba7f-ef83aae91578/source.png |
| `{{ S1_IMAGE_7 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/6ec01770-b0d6-41e2-85c1-5d7d96df6ae8/source.png |
| `{{ S1_IMAGE_8 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/f60bcaef-a8f2-4c98-8fba-d1ece2257473/source.png |
| `{{ S1_IMAGE_9 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/8abab57e-e31b-4abd-a0c7-4b460e1f7ce1/source.png |
| `{{ S1_IMAGE_10 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/949ae166-505a-40f1-a9ce-e6d5f67e769f/source.png |
| `{{ S1_Sub_Title_1 }}` | QUICK DEAL |
| `{{ S1_Title_2 }}` | SALES |
| `{{ S1_Discount }}` | 30% OFF |
| `{{ FONT_COLOR }}` | #ffffff |
| `{{ BACKGROUND_COLOR }}` | #524f4c |
| `{{ S2_IMAGE_11 }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/c59ad1d6-52b2-4ee6-b3b7-9fe77a9030a1/source.png |
| `{{ S2_CTA }}` | Shop with us |
| `{{ S2_handle }}` | @ fazmodel |
| `{{ AUDIO_SRC }}` | https://templates.shotstack.io/modern-sale-promo-grid-template/df31e2a2-3543-4862-92a6-7ac98c10fb05/source.mp3 |
| `{{ S1_Title_1 }}` | Summer Holiday |

## Template JSON

```json
{
  "timeline": {
    "fonts": [
      {
        "src": "https://templates.shotstack.io/modern-sale-promo-grid-template/9545c56e-5682-463f-b552-e39ef6ac7e2a/source.ttf"
      },
      {
        "src": "https://templates.shotstack.io/modern-sale-promo-grid-template/bd52325d-711d-4cfe-ac9d-f0218e94db9f/source.ttf"
      },
      {
        "src": "https://templates.shotstack.io/modern-sale-promo-grid-template/83b2444f-0dd7-4250-989e-5a407fe6b58c/source.ttf"
      }
    ],
    "background": "#FFFFFF",
    "tracks": [
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "audio",
              "src": "{{ AUDIO_SRC }}",
              "volume": 1
            },
            "start": 0
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S2_handle}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Oswald",
                "size": "70",
                "lineHeight": 1
              },
              "width": 700,
              "height": 72
            },
            "start": 5.27,
            "length": "end",
            "offset": {
              "x": 0,
              "y": -0.342
            },
            "position": "center",
            "transition": {
              "in": "slideDown"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S2_CTA}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Gistesy",
                "size": "180",
                "lineHeight": 1
              },
              "width": 900,
              "height": 300
            },
            "start": 4.9,
            "length": "end",
            "offset": {
              "x": 0,
              "y": -0.16
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ S2_IMAGE_11 }}"
            },
            "start": 4.62,
            "scale": 0.45,
            "transition": {
              "in": "slideRight"
            },
            "offset": {
              "x": 0,
              "y": 0.199
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S1_Discount}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Oswald",
                "size": "90",
                "lineHeight": 1
              },
              "width": 300,
              "height": 300
            },
            "start": 0.9,
            "length": 4,
            "offset": {
              "x": 0,
              "y": -0.179
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideDown"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S1_Sub_Title_1}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Oswald",
                "size": "90",
                "lineHeight": 1
              },
              "width": 300,
              "height": 300
            },
            "start": 0.4,
            "length": 4,
            "offset": {
              "x": 0,
              "y": 0.18
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_7 }}"
            },
            "start": 1,
            "scale": 0.13,
            "offset": {
              "x": 0.31,
              "y": -0.191
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 285,
              "height": 285,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 1,
            "length": 4,
            "offset": {
              "x": 0.31,
              "y": -0.191
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_6 }}"
            },
            "start": 0.8,
            "scale": 0.13,
            "offset": {
              "x": -0.316,
              "y": -0.19
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 285,
              "height": 285,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0.8,
            "length": 4,
            "offset": {
              "x": -0.316,
              "y": -0.191
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_10 }}"
            },
            "start": 1.3,
            "scale": 0.15,
            "offset": {
              "x": 0.31,
              "y": -0.359
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 3.99,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_8 }}"
            },
            "start": 1.1,
            "scale": 0.15,
            "offset": {
              "x": -0.316,
              "y": -0.362
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_9 }}"
            },
            "start": 1.2,
            "scale": 0.13,
            "offset": {
              "x": 0,
              "y": -0.359
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 285,
              "height": 285,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 1.2,
            "length": 4,
            "offset": {
              "x": 0,
              "y": -0.358
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_5 }}"
            },
            "start": 0.5,
            "scale": 0.15,
            "offset": {
              "x": 0.31,
              "y": 0.199
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_4 }}"
            },
            "start": 0.3,
            "scale": 0.15,
            "offset": {
              "x": -0.316,
              "y": 0.199
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_3 }}"
            },
            "start": 0.2,
            "scale": 0.13,
            "offset": {
              "x": 0.31,
              "y": 0.366
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 285,
              "height": 285,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0.2,
            "length": 4,
            "offset": {
              "x": 0.31,
              "y": 0.368
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_2 }}"
            },
            "start": 0.1,
            "scale": 0.15,
            "offset": {
              "x": 0,
              "y": 0.368
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4,
            "asset": {
              "type": "image",
              "src": "{{ S1_IMAGE_1 }}"
            },
            "start": 0,
            "scale": 0.13,
            "offset": {
              "x": -0.316,
              "y": 0.368
            },
            "position": "center",
            "transition": {
              "out": "slideRight",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 285,
              "height": 285,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0,
            "length": 4,
            "offset": {
              "x": -0.316,
              "y": 0.368
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S1_Title_2}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Oswald",
                "size": "150",
                "lineHeight": 1
              },
              "width": 700,
              "height": 300
            },
            "start": 0.7,
            "length": 4,
            "opacity": 1,
            "offset": {
              "x": 0,
              "y": -0.051
            },
            "position": "center",
            "transition": {
              "out": "slideUp",
              "in": "slideDown"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S1_Title_1}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Gistesy",
                "size": "150",
                "lineHeight": 1
              },
              "width": 900,
              "height": 250
            },
            "start": 0.6,
            "length": 4,
            "offset": {
              "x": 0,
              "y": 0.05
            },
            "position": "center",
            "transition": {
              "in": "slideDown",
              "out": "slideUp"
            }
          }
        ]
      },
      {
        "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 }}"
              }
            },
            "start": 0,
            "length": 9,
            "position": "center"
          }
        ]
      }
    ]
  },
  "output": {
    "format": "mp4",
    "fps": 25,
    "size": {
      "width": 1080,
      "height": 1920
    }
  },
  "merge": [
    {
      "find": "S1_IMAGE_1",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/9aeabfd9-71ad-4513-88e5-62d8458fb9e1/source.png"
    },
    {
      "find": "S1_IMAGE_2",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/6a69cfc8-e872-4295-bd30-70d71d7a669f/source.png"
    },
    {
      "find": "S1_IMAGE_3",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/871796d3-943b-4e14-8a09-5fc3abf79389/source.png"
    },
    {
      "find": "S1_IMAGE_4",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/f808e067-5ba8-49c4-921b-ef158b5ab077/source.png"
    },
    {
      "find": "S1_IMAGE_5",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/f5ba05ee-ac15-4a5a-8d4b-fba861aca796/source.png"
    },
    {
      "find": "S1_IMAGE_6",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/00fe6e0b-70a6-46e0-ba7f-ef83aae91578/source.png"
    },
    {
      "find": "S1_IMAGE_7",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/6ec01770-b0d6-41e2-85c1-5d7d96df6ae8/source.png"
    },
    {
      "find": "S1_IMAGE_8",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/f60bcaef-a8f2-4c98-8fba-d1ece2257473/source.png"
    },
    {
      "find": "S1_IMAGE_9",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/8abab57e-e31b-4abd-a0c7-4b460e1f7ce1/source.png"
    },
    {
      "find": "S1_IMAGE_10",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/949ae166-505a-40f1-a9ce-e6d5f67e769f/source.png"
    },
    {
      "find": "S1_Sub_Title_1",
      "replace": "QUICK DEAL"
    },
    {
      "find": "S1_Title_2",
      "replace": "SALES"
    },
    {
      "find": "S1_Discount",
      "replace": "30% OFF"
    },
    {
      "find": "FONT_COLOR",
      "replace": "#ffffff"
    },
    {
      "find": "BACKGROUND_COLOR",
      "replace": "#524f4c"
    },
    {
      "find": "S2_IMAGE_11",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/c59ad1d6-52b2-4ee6-b3b7-9fe77a9030a1/source.png"
    },
    {
      "find": "S2_CTA",
      "replace": "Shop with us"
    },
    {
      "find": "S2_handle",
      "replace": "@ fazmodel"
    },
    {
      "find": "AUDIO_SRC",
      "replace": "https://templates.shotstack.io/modern-sale-promo-grid-template/df31e2a2-3543-4862-92a6-7ac98c10fb05/source.mp3"
    },
    {
      "find": "S1_Title_1",
      "replace": "Summer Holiday"
    }
  ]
}
```

## 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