# Dynamic Offer Showcase Vertical Gallery Promo Template (video template)

> Boost your sales with this modern promo template. Features a large hero image, a vertical gallery, and bold text to grab customer attention.

## Overview

- **Page**: https://shotstack.io/studio/templates/promo-template-sale-announcement-image-gallery/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 5s
- **Timeline**: 18 clips on 17 tracks; assets: audio, image, luma, 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=eyJ0aW1lbGluZSI6eyJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPX1NSQyB9fSIsInZvbHVtZSI6MX0sInN0YXJ0IjowfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzUgfX0ifSwic3RhcnQiOjMuOTQ2MSwic2NhbGUiOjAuNTUsIm9mZnNldCI6eyJ5IjowLjE2OSwieCI6LTAuMDkyfSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGVGYXN0In0sInBvc2l0aW9uIjoiY2VudGVyIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEuMiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfNCB9fSJ9LCJzdGFydCI6Mi45Mjg5LCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZUZhc3QiLCJvdXQiOiJmYWRlRmFzdCJ9LCJzY2FsZSI6MC41NSwib2Zmc2V0Ijp7InkiOjAuMTY5LCJ4IjotMC4wOTJ9LCJwb3NpdGlvbiI6ImNlbnRlciJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoxLjQxLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV8zIH19In0sInN0YXJ0IjoxLjkzLCJzY2FsZSI6MC41NSwib2Zmc2V0Ijp7InkiOjAuMTY5LCJ4IjotMC4wOTJ9LCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZUZhc3QiLCJvdXQiOiJmYWRlRmFzdCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MS41MSwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfMiB9fSJ9LCJzdGFydCI6MC44MjExLCJzY2FsZSI6MC41NSwib2Zmc2V0Ijp7InkiOjAuMTY5LCJ4IjotMC4wOTJ9LCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZUZhc3QiLCJvdXQiOiJmYWRlRmFzdCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6MS4yLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV8xIH19In0sInN0YXJ0IjowLCJvZmZzZXQiOnsieSI6MC4xNjksIngiOi0wLjA5Mn0sInNjYWxlIjowLjU1LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0IjoiZmFkZUZhc3QifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQzMCwiaGVpZ2h0Ijo0MDAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19In19LCJzdGFydCI6MCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOlt7InN0YXJ0IjowLCJsZW5ndGgiOjAuODYsImZyb20iOjAuMzQ4LCJ0byI6MC4zNDgsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjowLjg2LCJsZW5ndGgiOjAuMjQsImZyb20iOjAuMzQ4LCJ0byI6MC4zNDgsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjoxLjEsImxlbmd0aCI6MC43OCwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjEuODgsImxlbmd0aCI6MC4yNiwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjIuMTQsImxlbmd0aCI6MC43NSwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjIuODksImxlbmd0aCI6MC4yOCwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjMuMTcsImxlbmd0aCI6MC43OSwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjMuOTYsImxlbmd0aCI6MC4yOSwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjQuMjUsImxlbmd0aCI6MC43NSwiZnJvbSI6MC4zNDgsInRvIjowLjM0OCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9XSwieSI6W3sic3RhcnQiOjAsImxlbmd0aCI6MC44NiwiZnJvbSI6MC4zNjcsInRvIjowLjM2MiwiaW50ZXJwb2xhdGlvbiI6ImJlemllciIsImVhc2luZyI6ImVhc2UifSx7InN0YXJ0IjowLjg2LCJsZW5ndGgiOjAuMjQsImZyb20iOjAuMzYyLCJ0byI6MC4xODEsImludGVycG9sYXRpb24iOiJiZXppZXIiLCJlYXNpbmciOiJlYXNlIn0seyJzdGFydCI6MS4xLCJsZW5ndGgiOjAuNzgsImZyb20iOjAuMTgxLCJ0byI6MC4xODEsImludGVycG9sYXRpb24iOiJiZXppZXIiLCJlYXNpbmciOiJlYXNlIn0seyJzdGFydCI6MS44OCwibGVuZ3RoIjowLjI2LCJmcm9tIjowLjE4MSwidG8iOi0wLjAwNSwiaW50ZXJwb2xhdGlvbiI6ImJlemllciIsImVhc2luZyI6ImVhc2UifSx7InN0YXJ0IjoyLjE0LCJsZW5ndGgiOjAuNzUsImZyb20iOi0wLjAwNSwidG8iOjAsImludGVycG9sYXRpb24iOiJiZXppZXIiLCJlYXNpbmciOiJlYXNlIn0seyJzdGFydCI6Mi44OSwibGVuZ3RoIjowLjI4LCJmcm9tIjowLCJ0byI6LTAuMTg3LCJpbnRlcnBvbGF0aW9uIjoiYmV6aWVyIiwiZWFzaW5nIjoiZWFzZSJ9LHsic3RhcnQiOjMuMTcsImxlbmd0aCI6MC43OSwiZnJvbSI6LTAuMTg3LCJ0byI6LTAuMTksImludGVycG9sYXRpb24iOiJiZXppZXIiLCJlYXNpbmciOiJlYXNlIn0seyJzdGFydCI6My45NiwibGVuZ3RoIjowLjI5LCJmcm9tIjotMC4xOSwidG8iOi0wLjM3LCJpbnRlcnBvbGF0aW9uIjoiYmV6aWVyIiwiZWFzaW5nIjoiZWFzZSJ9LHsic3RhcnQiOjQuMjUsImxlbmd0aCI6MC43NSwiZnJvbSI6LTAuMzcsInRvIjotMC4zNywiaW50ZXJwb2xhdGlvbiI6ImJlemllciIsImVhc2luZyI6ImVhc2UifV19LCJwb3NpdGlvbiI6ImNlbnRlciIsIm9wYWNpdHkiOlt7InN0YXJ0IjowLCJsZW5ndGgiOjAuODYsImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6MC44NiwibGVuZ3RoIjowLjI0LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjEuMSwibGVuZ3RoIjowLjc4LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjEuODgsImxlbmd0aCI6MC4yNiwiZnJvbSI6MSwidG8iOjEsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjoyLjE0LCJsZW5ndGgiOjAuNzUsImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6Mi44OSwibGVuZ3RoIjowLjI4LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjMuMTcsImxlbmd0aCI6MC43OSwiZnJvbSI6MSwidG8iOjEsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjozLjk2LCJsZW5ndGgiOjAuMjksImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6NC4yNSwibGVuZ3RoIjowLjc1LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9XSwic2NhbGUiOlt7InN0YXJ0IjowLCJsZW5ndGgiOjAuODYsImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6MC44NiwibGVuZ3RoIjowLjI0LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjEuMSwibGVuZ3RoIjowLjc4LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjEuODgsImxlbmd0aCI6MC4yNiwiZnJvbSI6MSwidG8iOjEsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjoyLjE0LCJsZW5ndGgiOjAuNzUsImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6Mi44OSwibGVuZ3RoIjowLjI4LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjMuMTcsImxlbmd0aCI6MC43OSwiZnJvbSI6MSwidG8iOjEsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjozLjk2LCJsZW5ndGgiOjAuMjksImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6NC4yNSwibGVuZ3RoIjowLjc1LCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9XSwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6W3sic3RhcnQiOjAsImxlbmd0aCI6MC44NiwiZnJvbSI6MCwidG8iOjAsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjowLjg2LCJsZW5ndGgiOjAuMjQsImZyb20iOjAsInRvIjowLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6MS4xLCJsZW5ndGgiOjAuNzgsImZyb20iOjAsInRvIjowLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6MS44OCwibGVuZ3RoIjowLjI2LCJmcm9tIjowLCJ0byI6MCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjIuMTQsImxlbmd0aCI6MC43NSwiZnJvbSI6MCwidG8iOjAsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0IjoyLjg5LCJsZW5ndGgiOjAuMjgsImZyb20iOjAsInRvIjowLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn0seyJzdGFydCI6My4xNywibGVuZ3RoIjowLjc5LCJmcm9tIjowLCJ0byI6MCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9LHsic3RhcnQiOjMuOTYsImxlbmd0aCI6MC4yOSwiZnJvbSI6MCwidG8iOjAsImludGVycG9sYXRpb24iOiJsaW5lYXIifSx7InN0YXJ0Ijo0LjI1LCJsZW5ndGgiOjAuNzUsImZyb20iOjAsInRvIjowLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dfX19LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vcHJvbW8tdGVtcGxhdGUtc2FsZS1hbm5vdW5jZW1lbnQtaW1hZ2UtZ2FsbGVyeS82ZDAwOTA3ZC04MjBjLTRmOWMtYTgzNC1kNGQwN2I2N2NjMjUvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwibGVuZ3RoIjo1fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7V2VifX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoiMzUiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjYwMCwiaGVpZ2h0Ijo3Mn0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMTE3LCJ5IjotMC40MjZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tDVEF9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IEJBQ0tHUk9VTkRfQ09MT1IgfX0iLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOiI1MCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NTAwLCJoZWlnaHQiOjEwMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMTYyLCJ5IjotMC4zNTN9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tEaXNjb3VudH19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6IjM1IiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo1MDAsImhlaWdodCI6NzJ9LCJzdGFydCI6MCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjE2MiwieSI6LTAuMjY0fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7VGl0dGxlfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6InRvcCJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6IjEyMCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NjUwLCJoZWlnaHQiOjMwMH0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMDkzLCJ5IjotMC4xOX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV81IH19In0sInN0YXJ0IjowLCJzY2FsZSI6MC4xNiwib2Zmc2V0Ijp7IngiOjAuMzQ4LCJ5IjotMC4zNjV9LCJwb3NpdGlvbiI6ImNlbnRlciJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfNCB9fSJ9LCJzdGFydCI6MCwic2NhbGUiOjAuMTYsIm9mZnNldCI6eyJ4IjowLjM0OCwieSI6LTAuMTg2fSwicG9zaXRpb24iOiJjZW50ZXIifV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzMgfX0ifSwic3RhcnQiOjAsInNjYWxlIjowLjE2LCJvZmZzZXQiOnsieCI6MC4zNDgsInkiOi0wLjAwNX0sInBvc2l0aW9uIjoiY2VudGVyIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV8yIH19In0sInN0YXJ0IjowLCJzY2FsZSI6MC4xNiwib2Zmc2V0Ijp7IngiOjAuMzQ4LCJ5IjowLjE3OX0sInBvc2l0aW9uIjoiY2VudGVyIn1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV8xIH19In0sInN0YXJ0IjowLCJvZmZzZXQiOnsieSI6MC4zNjQsIngiOjAuMzQ4fSwic2NhbGUiOjAuMTYsInBvc2l0aW9uIjoiY2VudGVyIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEJBQ0tHUk9VTkRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfX0sInN0YXJ0IjowLCJsZW5ndGgiOjUsInBvc2l0aW9uIjoiY2VudGVyIn1dfV19LCJvdXRwdXQiOnsiZm9ybWF0IjoibXA0IiwiZnBzIjoyNSwic2l6ZSI6eyJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwfX0sIm1lcmdlIjpbeyJmaW5kIjoiVGl0dGxlIiwicmVwbGFjZSI6IlNNQVJUIENIT0lDRSJ9LHsiZmluZCI6IkRpc2NvdW50IiwicmVwbGFjZSI6IlNBVkUgQklHIOKAkyBVUCBUTyA1MCUgT0ZGIn0seyJmaW5kIjoiQ1RBIiwicmVwbGFjZSI6Ik9SREVSIE5PVyJ9LHsiZmluZCI6IldlYiIsInJlcGxhY2UiOiJXV1cuSE9NRVRPT0xDSEVGLkNPTSJ9LHsiZmluZCI6IklNQUdFXzEiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3Byb21vLXRlbXBsYXRlLXNhbGUtYW5ub3VuY2VtZW50LWltYWdlLWdhbGxlcnkvNDYxNGMyYjUtY2FjMC00NjcwLWEyNjItMTJlMDA5MjJmYTk3L3NvdXJjZS5wbmcifSx7ImZpbmQiOiJJTUFHRV8yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9wcm9tby10ZW1wbGF0ZS1zYWxlLWFubm91bmNlbWVudC1pbWFnZS1nYWxsZXJ5Lzk4MTA0MjE2LWE2ZGItNDIzOC1iOTA5LTA4NDk1NmY4Y2IyOC9zb3VyY2UucG5nIn0seyJmaW5kIjoiSU1BR0VfMyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vcHJvbW8tdGVtcGxhdGUtc2FsZS1hbm5vdW5jZW1lbnQtaW1hZ2UtZ2FsbGVyeS83N2ZjNGE1Zi0wODg3LTRkODMtYmI1MS1kNmI1NWYzZWJiOGEvc291cmNlLnBuZyJ9LHsiZmluZCI6IklNQUdFXzQiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3Byb21vLXRlbXBsYXRlLXNhbGUtYW5ub3VuY2VtZW50LWltYWdlLWdhbGxlcnkvY2NkMTI1ZGUtZDFjMC00ZWEzLWI2ZTctZTAyYWJiM2EzMzJhL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJJTUFHRV81IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9wcm9tby10ZW1wbGF0ZS1zYWxlLWFubm91bmNlbWVudC1pbWFnZS1nYWxsZXJ5LzVkZWQ3MGMyLTEzYTQtNDYwYy04ZjBlLTRhODE2MThmZjAwYy9zb3VyY2UucG5nIn0seyJmaW5kIjoiRk9OVF9DT0xPUiIsInJlcGxhY2UiOiIjZmZmZmZmIn0seyJmaW5kIjoiQkFDS0dST1VORF9DT0xPUiIsInJlcGxhY2UiOiIjNDc0MzQzIn0seyJmaW5kIjoiQVVESU9fU1JDIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9wcm9tby10ZW1wbGF0ZS1zYWxlLWFubm91bmNlbWVudC1pbWFnZS1nYWxsZXJ5LzgwNTQ4NjJkLWUxYjYtNGU4MS1iMWQ3LTc5ZDQ1YjNhZWJlYS9zb3VyY2UubXAzIn1dfQ
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/promo-template-sale-announcement-image-gallery

## 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 |
| --- | --- |
| `{{ Tittle }}` | SMART CHOICE |
| `{{ Discount }}` | SAVE BIG – UP TO 50% OFF |
| `{{ CTA }}` | ORDER NOW |
| `{{ Web }}` | WWW.HOMETOOLCHEF.COM |
| `{{ IMAGE_1 }}` | https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/4614c2b5-cac0-4670-a262-12e00922fa97/source.png |
| `{{ IMAGE_2 }}` | https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/98104216-a6db-4238-b909-084956f8cb28/source.png |
| `{{ IMAGE_3 }}` | https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/77fc4a5f-0887-4d83-bb51-d6b55f3ebb8a/source.png |
| `{{ IMAGE_4 }}` | https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/ccd125de-d1c0-4ea3-b6e7-e02abb3a332a/source.png |
| `{{ IMAGE_5 }}` | https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/5ded70c2-13a4-460c-8f0e-4a81618ff00c/source.png |
| `{{ FONT_COLOR }}` | #ffffff |
| `{{ BACKGROUND_COLOR }}` | #474343 |
| `{{ AUDIO_SRC }}` | https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/8054862d-e1b6-4e81-b1d7-79d45b3aebea/source.mp3 |

## Template JSON

```json
{
  "timeline": {
    "background": "#FFFFFF",
    "tracks": [
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "audio",
              "src": "{{ AUDIO_SRC }}",
              "volume": 1
            },
            "start": 0
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_5 }}"
            },
            "start": 3.9461,
            "scale": 0.55,
            "offset": {
              "y": 0.169,
              "x": -0.092
            },
            "transition": {
              "in": "fadeFast"
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1.2,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_4 }}"
            },
            "start": 2.9289,
            "transition": {
              "in": "fadeFast",
              "out": "fadeFast"
            },
            "scale": 0.55,
            "offset": {
              "y": 0.169,
              "x": -0.092
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1.41,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_3 }}"
            },
            "start": 1.93,
            "scale": 0.55,
            "offset": {
              "y": 0.169,
              "x": -0.092
            },
            "transition": {
              "in": "fadeFast",
              "out": "fadeFast"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1.51,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_2 }}"
            },
            "start": 0.8211,
            "scale": 0.55,
            "offset": {
              "y": 0.169,
              "x": -0.092
            },
            "transition": {
              "in": "fadeFast",
              "out": "fadeFast"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 1.2,
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_1 }}"
            },
            "start": 0,
            "offset": {
              "y": 0.169,
              "x": -0.092
            },
            "scale": 0.55,
            "position": "center",
            "transition": {
              "out": "fadeFast"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 430,
              "height": 400,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0,
            "length": "end",
            "offset": {
              "x": [
                {
                  "start": 0,
                  "length": 0.86,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 0.86,
                  "length": 0.24,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 1.1,
                  "length": 0.78,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 1.88,
                  "length": 0.26,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 2.14,
                  "length": 0.75,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 2.89,
                  "length": 0.28,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 3.17,
                  "length": 0.79,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 3.96,
                  "length": 0.29,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                },
                {
                  "start": 4.25,
                  "length": 0.75,
                  "from": 0.348,
                  "to": 0.348,
                  "interpolation": "linear"
                }
              ],
              "y": [
                {
                  "start": 0,
                  "length": 0.86,
                  "from": 0.367,
                  "to": 0.362,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 0.86,
                  "length": 0.24,
                  "from": 0.362,
                  "to": 0.181,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 1.1,
                  "length": 0.78,
                  "from": 0.181,
                  "to": 0.181,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 1.88,
                  "length": 0.26,
                  "from": 0.181,
                  "to": -0.005,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 2.14,
                  "length": 0.75,
                  "from": -0.005,
                  "to": 0,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 2.89,
                  "length": 0.28,
                  "from": 0,
                  "to": -0.187,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 3.17,
                  "length": 0.79,
                  "from": -0.187,
                  "to": -0.19,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 3.96,
                  "length": 0.29,
                  "from": -0.19,
                  "to": -0.37,
                  "interpolation": "bezier",
                  "easing": "ease"
                },
                {
                  "start": 4.25,
                  "length": 0.75,
                  "from": -0.37,
                  "to": -0.37,
                  "interpolation": "bezier",
                  "easing": "ease"
                }
              ]
            },
            "position": "center",
            "opacity": [
              {
                "start": 0,
                "length": 0.86,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 0.86,
                "length": 0.24,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 1.1,
                "length": 0.78,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 1.88,
                "length": 0.26,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 2.14,
                "length": 0.75,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 2.89,
                "length": 0.28,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 3.17,
                "length": 0.79,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 3.96,
                "length": 0.29,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 4.25,
                "length": 0.75,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              }
            ],
            "scale": [
              {
                "start": 0,
                "length": 0.86,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 0.86,
                "length": 0.24,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 1.1,
                "length": 0.78,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 1.88,
                "length": 0.26,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 2.14,
                "length": 0.75,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 2.89,
                "length": 0.28,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 3.17,
                "length": 0.79,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 3.96,
                "length": 0.29,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              },
              {
                "start": 4.25,
                "length": 0.75,
                "from": 1,
                "to": 1,
                "interpolation": "linear"
              }
            ],
            "transform": {
              "rotate": {
                "angle": [
                  {
                    "start": 0,
                    "length": 0.86,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 0.86,
                    "length": 0.24,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 1.1,
                    "length": 0.78,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 1.88,
                    "length": 0.26,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 2.14,
                    "length": 0.75,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 2.89,
                    "length": 0.28,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 3.17,
                    "length": 0.79,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 3.96,
                    "length": 0.29,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  },
                  {
                    "start": 4.25,
                    "length": 0.75,
                    "from": 0,
                    "to": 0,
                    "interpolation": "linear"
                  }
                ]
              }
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/6d00907d-820c-4f9c-a834-d4d07b67cc25/source.png"
            },
            "start": 0,
            "length": 5
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Web}}",
              "alignment": {
                "horizontal": "left",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Montserrat SemiBold",
                "size": "35",
                "lineHeight": 1
              },
              "width": 600,
              "height": 72
            },
            "start": 0,
            "length": "end",
            "offset": {
              "x": -0.117,
              "y": -0.426
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{CTA}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ BACKGROUND_COLOR }}",
                "family": "Montserrat ExtraBold",
                "size": "50",
                "lineHeight": 1
              },
              "width": 500,
              "height": 100,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0,
            "length": "end",
            "offset": {
              "x": -0.162,
              "y": -0.353
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Discount}}",
              "alignment": {
                "horizontal": "left",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Montserrat SemiBold",
                "size": "35",
                "lineHeight": 1
              },
              "width": 500,
              "height": 72
            },
            "start": 0,
            "length": "end",
            "offset": {
              "x": -0.162,
              "y": -0.264
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Tittle}}",
              "alignment": {
                "horizontal": "left",
                "vertical": "top"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Montserrat ExtraBold",
                "size": "120",
                "lineHeight": 1
              },
              "width": 650,
              "height": 300
            },
            "start": 0,
            "length": "end",
            "offset": {
              "x": -0.093,
              "y": -0.19
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_5 }}"
            },
            "start": 0,
            "scale": 0.16,
            "offset": {
              "x": 0.348,
              "y": -0.365
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_4 }}"
            },
            "start": 0,
            "scale": 0.16,
            "offset": {
              "x": 0.348,
              "y": -0.186
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_3 }}"
            },
            "start": 0,
            "scale": 0.16,
            "offset": {
              "x": 0.348,
              "y": -0.005
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_2 }}"
            },
            "start": 0,
            "scale": 0.16,
            "offset": {
              "x": 0.348,
              "y": 0.179
            },
            "position": "center"
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ IMAGE_1 }}"
            },
            "start": 0,
            "offset": {
              "y": 0.364,
              "x": 0.348
            },
            "scale": 0.16,
            "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 }}",
                "opacity": 1
              }
            },
            "start": 0,
            "length": 5,
            "position": "center"
          }
        ]
      }
    ]
  },
  "output": {
    "format": "mp4",
    "fps": 25,
    "size": {
      "width": 1080,
      "height": 1920
    }
  },
  "merge": [
    {
      "find": "Tittle",
      "replace": "SMART CHOICE"
    },
    {
      "find": "Discount",
      "replace": "SAVE BIG – UP TO 50% OFF"
    },
    {
      "find": "CTA",
      "replace": "ORDER NOW"
    },
    {
      "find": "Web",
      "replace": "WWW.HOMETOOLCHEF.COM"
    },
    {
      "find": "IMAGE_1",
      "replace": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/4614c2b5-cac0-4670-a262-12e00922fa97/source.png"
    },
    {
      "find": "IMAGE_2",
      "replace": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/98104216-a6db-4238-b909-084956f8cb28/source.png"
    },
    {
      "find": "IMAGE_3",
      "replace": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/77fc4a5f-0887-4d83-bb51-d6b55f3ebb8a/source.png"
    },
    {
      "find": "IMAGE_4",
      "replace": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/ccd125de-d1c0-4ea3-b6e7-e02abb3a332a/source.png"
    },
    {
      "find": "IMAGE_5",
      "replace": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/5ded70c2-13a4-460c-8f0e-4a81618ff00c/source.png"
    },
    {
      "find": "FONT_COLOR",
      "replace": "#ffffff"
    },
    {
      "find": "BACKGROUND_COLOR",
      "replace": "#474343"
    },
    {
      "find": "AUDIO_SRC",
      "replace": "https://templates.shotstack.io/promo-template-sale-announcement-image-gallery/8054862d-e1b6-4e81-b1d7-79d45b3aebea/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