# Christmas Special Offer Template for Holiday Sales (video template) > Promote your Christmas deals with this eye-catching template. Perfect for holiday offers and festive sales! ## Overview - **Page**: https://shotstack.io/studio/templates/christmas-special-offer-template-for-holiday-sales/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 8.1s - **Timeline**: 21 clips on 18 tracks; assets: audio, image, luma, text, video - **Render endpoint (sandbox, free, watermarked)**: POST https://api.shotstack.io/edit/stage/render with header `x-api-key` - **Production**: same request against https://api.shotstack.io/edit/v1/render with a v1 key - **Preview in the browser (no account)**: https://shotstack.studio/#json=eyJ0aW1lbGluZSI6eyJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPX1NSQyB9fSIsInZvbHVtZSI6MX0sInN0YXJ0IjowfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImZpdCI6ImNvbnRhaW4iLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vY2hyaXN0bWFzLXNwZWNpYWwtb2ZmZXItdGVtcGxhdGUtZm9yLWhvbGlkYXktc2FsZXMvbmUzc2U5a21xcmhrM2Z2bG5mZGxtZHgzL3NvdXJjZV82NDA4NTY0MS53ZWJtIn0sInN0YXJ0IjowLCJzY2FsZSI6MX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJhdXRvIiwiZml0IjoiY29udGFpbiIsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9jaHJpc3RtYXMtc3BlY2lhbC1vZmZlci10ZW1wbGF0ZS1mb3ItaG9saWRheS1zYWxlcy9uZTNzZTlrbXFyaGszZnZsbmZkbG1keDMvc291cmNlXzg1MTZhMGRjLndlYm0ifSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIHt7Q1RBfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJTdWUgRWxsZW4gRnJhbmNpc2NvICIsInNpemUiOiIxMDAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjgwMCwiaGVpZ2h0IjoxNzB9LCJzdGFydCI6OC42NSwibGVuZ3RoIjoiZW5kIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MyX0xJTkVfMn19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiU3VlIEVsbGVuIEZyYW5jaXNjbyAiLCJzaXplIjo3MiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo4MDAsImhlaWdodCI6MTcwfSwic3RhcnQiOjUuNTYsImxlbmd0aCI6Mi40OSwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjAyM30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIge3tTMl9MSU5FXzF9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IFRFWFRfRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6IlN1ZSBFbGxlbiBGcmFuY2lzY28gIiwic2l6ZSI6NzIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjEwMH0sInN0YXJ0Ijo1LjI1LCJsZW5ndGgiOjIuNzgsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjAzOH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MxX0RFU0NSSVBUSU9OXzJ9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IFRFWFRfRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6IlN1ZSBFbGxlbiBGcmFuY2lzY28gIiwic2l6ZSI6NzIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjEwMH0sInN0YXJ0IjowLjYsImxlbmd0aCI6My40MSwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjI3NX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6Inpvb20ifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MxX0RFU0NSSVBUSU9OfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJTdWUgRWxsZW4gRnJhbmNpc2NvICIsInNpemUiOiI5NyIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjEzMH0sInN0YXJ0IjowLjQzLCJsZW5ndGgiOjMuNTcsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4yMn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6Inpvb20ifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MxX1RJVExFfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJTdWUgRWxsZW4gRnJhbmNpc2NvICIsInNpemUiOiI2NyIsImxpbmVIZWlnaHQiOjEsIm9wYWNpdHkiOjF9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjEwMH0sInN0YXJ0IjowLCJsZW5ndGgiOjQsIm9mZnNldCI6eyJ4IjowLjAyOCwieSI6MC4yNDd9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIn19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgU0lERV9ERVNJR04gfX0ifSwic3RhcnQiOjAsInNjYWxlIjpbeyJzdGFydCI6MCwibGVuZ3RoIjo5LjkzLCJmcm9tIjowLjMsInRvIjowLjMsImludGVycG9sYXRpb24iOiJsaW5lYXIifV0sIm9mZnNldCI6eyJ4IjpbeyJzdGFydCI6MCwibGVuZ3RoIjo5LjkzLCJmcm9tIjowLjQ4NywidG8iOjAuNDg3LCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dLCJ5IjpbeyJzdGFydCI6MCwibGVuZ3RoIjo5LjkzLCJmcm9tIjowLjQ5MywidG8iOjAuNDkzLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dfSwicG9zaXRpb24iOiJjZW50ZXIiLCJvcGFjaXR5IjpbeyJzdGFydCI6MCwibGVuZ3RoIjo5LjkzLCJmcm9tIjoxLCJ0byI6MSwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9XSwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6W3sic3RhcnQiOjAsImxlbmd0aCI6OS45MywiZnJvbSI6MCwidG8iOjE4MCwiaW50ZXJwb2xhdGlvbiI6ImxpbmVhciJ9XX19fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFNJREVfREVTSUdOIH19In0sInN0YXJ0IjowLCJzY2FsZSI6W3sic3RhcnQiOjAsImxlbmd0aCI6OS45MywiZnJvbSI6MC4zLCJ0byI6MC4zLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dLCJvZmZzZXQiOnsieCI6W3sic3RhcnQiOjAsImxlbmd0aCI6OS45MywiZnJvbSI6LTAuNDUzLCJ0byI6LTAuNDUzLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dLCJ5IjpbeyJzdGFydCI6MCwibGVuZ3RoIjo5LjkzLCJmcm9tIjotMC40NDQsInRvIjotMC40NDQsImludGVycG9sYXRpb24iOiJsaW5lYXIifV19LCJwb3NpdGlvbiI6ImNlbnRlciIsIm9wYWNpdHkiOlt7InN0YXJ0IjowLCJsZW5ndGgiOjkuOTMsImZyb20iOjEsInRvIjoxLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjpbeyJzdGFydCI6MCwibGVuZ3RoIjo5LjkzLCJmcm9tIjowLCJ0byI6MTgwLCJpbnRlcnBvbGF0aW9uIjoibGluZWFyIn1dfX19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBMb2dvIH19In0sInN0YXJ0IjowLCJzY2FsZSI6MC4wNywib2Zmc2V0Ijp7IngiOjAsInkiOjAuMjk5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZSQU1FX0NPTE9SIH19In19LCJzdGFydCI6MCwibGVuZ3RoIjoiZW5kIn0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9jaHJpc3RtYXMtc3BlY2lhbC1vZmZlci10ZW1wbGF0ZS1mb3ItaG9saWRheS1zYWxlcy84NWZlZjMwNC0wN2RiLTQxMjMtOGJjOS1kMGIzNDIxMTM3YTYvc291cmNlLm1wNCJ9LCJzdGFydCI6MCwibGVuZ3RoIjoiZW5kIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjo3MiwibGluZUhlaWdodCI6MX0sIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBTSEFET1dfQ09MT1IgfX0ifX0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2NocmlzdG1hcy1zcGVjaWFsLW9mZmVyLXRlbXBsYXRlLWZvci1ob2xpZGF5LXNhbGVzL2ZhNjBhMDZjLWYyNDItNDU2OS1iMWYxLTQ5MTIzZDExZTBmZC9zb3VyY2UubXA0In0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEJBQ0tHUk9VTkRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2NocmlzdG1hcy1zcGVjaWFsLW9mZmVyLXRlbXBsYXRlLWZvci1ob2xpZGF5LXNhbGVzL2UzODUwMGYzLWQ2ZTgtNDFmNC1iYzM4LWYyYzcxYmNhZWE2Yi9zb3VyY2UubXA0In0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9jaHJpc3RtYXMtc3BlY2lhbC1vZmZlci10ZW1wbGF0ZS1mb3ItaG9saWRheS1zYWxlcy9lOWQ1MGUxMC04MDJhLTRlMWItOWE4NC00MDc1OTRjNmRiNjIvc2hvdHN0YWNrLXByb3h5LndlYnAifSwic3RhcnQiOjQuNzUsIm9mZnNldCI6eyJ4IjowLjEyOSwieSI6LTAuMjYyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJzY2FsZSI6MC41fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9jaHJpc3RtYXMtc3BlY2lhbC1vZmZlci10ZW1wbGF0ZS1mb3ItaG9saWRheS1zYWxlcy8zNTcwOTM1Yi01YzQwLTRkODItYmNkYy0wYTMyNTlkNmU2Njkvc2hvdHN0YWNrLXByb3h5LndlYnAifSwic3RhcnQiOjQuNzcsIm9mZnNldCI6eyJ4IjotMC4xNjcsInkiOjAuMjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInNjYWxlIjowLjV9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjM3LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vY2hyaXN0bWFzLXNwZWNpYWwtb2ZmZXItdGVtcGxhdGUtZm9yLWhvbGlkYXktc2FsZXMvNDljMGVkYjUtOTliZC00NjY1LTlmYTUtOTgyNGRkYzJkYTMzL3Nob3RzdGFjay1wcm94eS53ZWJwIn0sInN0YXJ0IjowLCJzY2FsZSI6MC41LCJvZmZzZXQiOnsieCI6MC4wMjgsInkiOjAuMDY0fSwicG9zaXRpb24iOiJjZW50ZXIifV19XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9fSwibWVyZ2UiOlt7ImZpbmQiOiJMb2dvIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9jaHJpc3RtYXMtc3BlY2lhbC1vZmZlci10ZW1wbGF0ZS1mb3ItaG9saWRheS1zYWxlcy9mNDQxMDg4Ni1mZjFhLTQyZmEtOWIwMi0yODllY2FkNjliODYvc291cmNlLnBuZyJ9LHsiZmluZCI6IlMxX1RJVExFIiwicmVwbGFjZSI6IkdJVkVTIFlPVSJ9LHsiZmluZCI6IlMxX0RFU0NSSVBUSU9OIiwicmVwbGFjZSI6IkNIUklTVE1BUyJ9LHsiZmluZCI6IlMxX0RFU0NSSVBUSU9OXzIiLCJyZXBsYWNlIjoiU1BFQ0lBTCBPRkZFUlMifSx7ImZpbmQiOiJTMV9JTUFHRV9TUkMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2NocmlzdG1hcy1zcGVjaWFsLW9mZmVyLXRlbXBsYXRlLWZvci1ob2xpZGF5LXNhbGVzLzk0ODVhZDAyLTFkZGMtNDY4Mi04YzQ3LWZmOGVkZjA0ZmRjZS9zaG90c3RhY2stcHJveHkud2VicCJ9LHsiZmluZCI6IkJBQ0tHUk9VTkRfQ09MT1IiLCJyZXBsYWNlIjoiI2Y1MDAwMCJ9LHsiZmluZCI6IlNIQURPV19DT0xPUiIsInJlcGxhY2UiOiIjYTIxNjE2In0seyJmaW5kIjoiRlJBTUVfQ09MT1IiLCJyZXBsYWNlIjoiI2ZmOGQwYSJ9LHsiZmluZCI6IlMyX0xJTkVfMSIsInJlcGxhY2UiOiJFTkpPWSBUSElTIn0seyJmaW5kIjoiUzJfTElORV8yIiwicmVwbGFjZSI6IlNFQVNPTiBXSVRIIFVTLCBKT0hOIn0seyJmaW5kIjoiUzJfSU1BR0VfU1JDIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9jaHJpc3RtYXMtc3BlY2lhbC1vZmZlci10ZW1wbGF0ZS1mb3ItaG9saWRheS1zYWxlcy9jODQxNTI0NC0wYzE5LTQ2YzEtOWQ3MC02MjA4ZGY3NzI4YWUvc2hvdHN0YWNrLXByb3h5LndlYnAifSx7ImZpbmQiOiJTMl9JTUFHRV9TUkNfMiIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vY2hyaXN0bWFzLXNwZWNpYWwtb2ZmZXItdGVtcGxhdGUtZm9yLWhvbGlkYXktc2FsZXMvMmFlZDU3ZTEtYTIwMi00MGJjLWIxOWMtYmFlOGRlODExOGJkL3Nob3RzdGFjay1wcm94eS53ZWJwIn0seyJmaW5kIjoiU0lERV9ERVNJR04iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2NocmlzdG1hcy1zcGVjaWFsLW9mZmVyLXRlbXBsYXRlLWZvci1ob2xpZGF5LXNhbGVzLzM2MWY3OTczLWNjMzAtNDY1Yi05NTUyLTYwYmZhZjM5NmYwMC9zaG90c3RhY2stcHJveHkud2VicCJ9LHsiZmluZCI6IkNUQSIsInJlcGxhY2UiOiJUSEFOSyBZT1UhIn0seyJmaW5kIjoiVEVYVF9GT05UX0NPTE9SIiwicmVwbGFjZSI6IiNmZmRhMWYifSx7ImZpbmQiOiJBVURJT19TUkMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2NocmlzdG1hcy1zcGVjaWFsLW9mZmVyLXRlbXBsYXRlLWZvci1ob2xpZGF5LXNhbGVzLzg4NzJkNGM0LTg0ZTktNDZlOC1iNThiLWNmZTBiNmZmMDM3Yy9zb3VyY2UubXAzIn1dfQ - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/christmas-special-offer-template-for-holiday-sales ## 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 | | --- | --- | | `{{ Logo }}` | https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/f4410886-ff1a-42fa-9b02-289ecad69b86/source.png | | `{{ S1_TITLE }}` | GIVES YOU | | `{{ S1_DESCRIPTION }}` | CHRISTMAS | | `{{ S1_DESCRIPTION_2 }}` | SPECIAL OFFERS | | `{{ S1_IMAGE_SRC }}` | https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/9485ad02-1ddc-4682-8c47-ff8edf04fdce/shotstack-proxy.webp | | `{{ BACKGROUND_COLOR }}` | #f50000 | | `{{ SHADOW_COLOR }}` | #a21616 | | `{{ FRAME_COLOR }}` | #ff8d0a | | `{{ S2_LINE_1 }}` | ENJOY THIS | | `{{ S2_LINE_2 }}` | SEASON WITH US, JOHN | | `{{ S2_IMAGE_SRC }}` | https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/c8415244-0c19-46c1-9d70-6208df7728ae/shotstack-proxy.webp | | `{{ S2_IMAGE_SRC_2 }}` | https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/2aed57e1-a202-40bc-b19c-bae8de8118bd/shotstack-proxy.webp | | `{{ SIDE_DESIGN }}` | https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/361f7973-cc30-465b-9552-60bfaf396f00/shotstack-proxy.webp | | `{{ CTA }}` | THANK YOU! | | `{{ TEXT_FONT_COLOR }}` | #ffda1f | | `{{ AUDIO_SRC }}` | https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/8872d4c4-84e9-46e8-b58b-cfe0b6ff037c/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", "fit": "contain", "asset": { "type": "video", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/ne3se9kmqrhk3fvlnfdlmdx3/source_64085641.webm" }, "start": 0, "scale": 1 } ] }, { "clips": [ { "length": "auto", "fit": "contain", "asset": { "type": "video", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/ne3se9kmqrhk3fvlnfdlmdx3/source_8516a0dc.webm" }, "start": 0 } ] }, { "clips": [ { "asset": { "type": "text", "text": " {{CTA}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Sue Ellen Francisco ", "size": "100", "lineHeight": 1 }, "width": 800, "height": 170 }, "start": 8.65, "length": "end", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S2_LINE_2}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Sue Ellen Francisco ", "size": 72, "lineHeight": 1 }, "width": 800, "height": 170 }, "start": 5.56, "length": 2.49, "offset": { "x": 0, "y": -0.023 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": " {{S2_LINE_1}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Sue Ellen Francisco ", "size": 72, "lineHeight": 1 }, "width": 800, "height": 100 }, "start": 5.25, "length": 2.78, "offset": { "x": 0, "y": 0.038 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_DESCRIPTION_2}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Sue Ellen Francisco ", "size": 72, "lineHeight": 1 }, "width": 800, "height": 100 }, "start": 0.6, "length": 3.41, "offset": { "x": 0, "y": -0.275 }, "position": "center", "transition": { "in": "zoom" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_DESCRIPTION}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Sue Ellen Francisco ", "size": "97", "lineHeight": 1 }, "width": 800, "height": 130 }, "start": 0.43, "length": 3.57, "offset": { "x": 0, "y": -0.22 }, "position": "center", "transition": { "in": "zoom" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_TITLE}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Sue Ellen Francisco ", "size": "67", "lineHeight": 1, "opacity": 1 }, "width": 800, "height": 100 }, "start": 0, "length": 4, "offset": { "x": 0.028, "y": 0.247 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "{{ SIDE_DESIGN }}" }, "start": 0, "scale": [ { "start": 0, "length": 9.93, "from": 0.3, "to": 0.3, "interpolation": "linear" } ], "offset": { "x": [ { "start": 0, "length": 9.93, "from": 0.487, "to": 0.487, "interpolation": "linear" } ], "y": [ { "start": 0, "length": 9.93, "from": 0.493, "to": 0.493, "interpolation": "linear" } ] }, "position": "center", "opacity": [ { "start": 0, "length": 9.93, "from": 1, "to": 1, "interpolation": "linear" } ], "transform": { "rotate": { "angle": [ { "start": 0, "length": 9.93, "from": 0, "to": 180, "interpolation": "linear" } ] } } } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "{{ SIDE_DESIGN }}" }, "start": 0, "scale": [ { "start": 0, "length": 9.93, "from": 0.3, "to": 0.3, "interpolation": "linear" } ], "offset": { "x": [ { "start": 0, "length": 9.93, "from": -0.453, "to": -0.453, "interpolation": "linear" } ], "y": [ { "start": 0, "length": 9.93, "from": -0.444, "to": -0.444, "interpolation": "linear" } ] }, "position": "center", "opacity": [ { "start": 0, "length": 9.93, "from": 1, "to": 1, "interpolation": "linear" } ], "transform": { "rotate": { "angle": [ { "start": 0, "length": 9.93, "from": 0, "to": 180, "interpolation": "linear" } ] } } } ] }, { "clips": [ { "length": 4, "asset": { "type": "image", "src": "{{ Logo }}" }, "start": 0, "scale": 0.07, "offset": { "x": 0, "y": 0.299 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 1080, "height": 1920, "background": { "color": "{{ FRAME_COLOR }}" } }, "start": 0, "length": "end" }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/85fef304-07db-4123-8bc9-d0b3421137a6/source.mp4" }, "start": 0, "length": "end" } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 1080, "height": 1920, "background": { "color": "{{ SHADOW_COLOR }}" } }, "start": 0, "length": "end" }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/fa60a06c-f242-4569-b1f1-49123d11e0fd/source.mp4" }, "start": 0, "length": "end" } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 1080, "height": 1920, "background": { "color": "{{ BACKGROUND_COLOR }}" } }, "start": 0, "length": "end" }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/e38500f3-d6e8-41f4-bc38-f2c71bcaea6b/source.mp4" }, "start": 0, "length": "end" } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/e9d50e10-802a-4e1b-9a84-407594c6db62/shotstack-proxy.webp" }, "start": 4.75, "offset": { "x": 0.129, "y": -0.262 }, "position": "center", "scale": 0.5 } ] }, { "clips": [ { "length": "end", "asset": { "type": "image", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/3570935b-5c40-4d82-bcdc-0a3259d6e669/shotstack-proxy.webp" }, "start": 4.77, "offset": { "x": -0.167, "y": 0.25 }, "position": "center", "scale": 0.5 } ] }, { "clips": [ { "length": 4.37, "asset": { "type": "image", "src": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/49c0edb5-99bd-4665-9fa5-9824ddc2da33/shotstack-proxy.webp" }, "start": 0, "scale": 0.5, "offset": { "x": 0.028, "y": 0.064 }, "position": "center" } ] } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 } }, "merge": [ { "find": "Logo", "replace": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/f4410886-ff1a-42fa-9b02-289ecad69b86/source.png" }, { "find": "S1_TITLE", "replace": "GIVES YOU" }, { "find": "S1_DESCRIPTION", "replace": "CHRISTMAS" }, { "find": "S1_DESCRIPTION_2", "replace": "SPECIAL OFFERS" }, { "find": "S1_IMAGE_SRC", "replace": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/9485ad02-1ddc-4682-8c47-ff8edf04fdce/shotstack-proxy.webp" }, { "find": "BACKGROUND_COLOR", "replace": "#f50000" }, { "find": "SHADOW_COLOR", "replace": "#a21616" }, { "find": "FRAME_COLOR", "replace": "#ff8d0a" }, { "find": "S2_LINE_1", "replace": "ENJOY THIS" }, { "find": "S2_LINE_2", "replace": "SEASON WITH US, JOHN" }, { "find": "S2_IMAGE_SRC", "replace": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/c8415244-0c19-46c1-9d70-6208df7728ae/shotstack-proxy.webp" }, { "find": "S2_IMAGE_SRC_2", "replace": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/2aed57e1-a202-40bc-b19c-bae8de8118bd/shotstack-proxy.webp" }, { "find": "SIDE_DESIGN", "replace": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/361f7973-cc30-465b-9552-60bfaf396f00/shotstack-proxy.webp" }, { "find": "CTA", "replace": "THANK YOU!" }, { "find": "TEXT_FONT_COLOR", "replace": "#ffda1f" }, { "find": "AUDIO_SRC", "replace": "https://templates.shotstack.io/christmas-special-offer-template-for-holiday-sales/8872d4c4-84e9-46e8-b58b-cfe0b6ff037c/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