# Local News Intro with Overlay (video template)
> A local news intro video template with blue overlay animations and merge fields for city name and images
## Overview
- **Page**: https://shotstack.io/studio/templates/breaking-news-overlay-v2/
- **Output**: MP4, 1920x1080 (16:9)
- **Length**: 24s
- **Timeline**: 22 clips on 22 tracks; assets: image, rich-text, svg, video
- **Render endpoint (sandbox, free, watermarked)**: POST https://api.shotstack.io/edit/stage/render with header `x-api-key`
- **Production**: same request against https://api.shotstack.io/edit/v1/render with a v1 key
- **Preview in the browser (no account)**: https://shotstack.studio/#json=eyJ0aW1lbGluZSI6eyJzb3VuZHRyYWNrIjp7InNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9icmVha2luZy1uZXdzLW92ZXJsYXkvN2U5OWViZTgtNzIwNy00YjUwLWFlM2QtYzJjMzEzMmY4OGRiL3Zpb3Npbi5tcDMiLCJlZmZlY3QiOiJmYWRlT3V0In0sImJhY2tncm91bmQiOiIjZmZmZmZmIiwidHJhY2tzIjpbeyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJPbiB0aGUgSGFyYm91ciIsImZvbnQiOnsiZmFtaWx5IjoiSlRVU2pJZzFfaTZ0OGtDSEttNDV4VzVyeWdiaTQ5YyIsInNpemUiOjUwLCJ3ZWlnaHQiOjUwMCwiY29sb3IiOiIjMDAwMDAwIiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLjIsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJyaWdodCIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sImZpdCI6Im5vbmUiLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMDYsInkiOjAuMDU2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJsZW5ndGgiOjguNSwic3RhcnQiOjE1LjUsIndpZHRoIjoxMDAwLCJoZWlnaHQiOjMwMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vYnJlYWtpbmctbmV3cy1vdmVybGF5L3NlMmMyYjZvejFldDFpbmpwZHpsNmQwZy9zb3VyY2VfZmU0OGI1MDYud2VibSJ9LCJvZmZzZXQiOnsieCI6MC4xNzI2NjY4MDg2MTkxODU2LCJ5IjowLjEzN30sInBvc2l0aW9uIjoiY2VudGVyIiwibGVuZ3RoIjo4LjksInNjYWxlIjoxLCJzdGFydCI6MTUuMSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo5MDcsImhlaWdodCI6NDU2fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0IjoiQm9hdCBSYWNlIiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6NzUsIndlaWdodCI6NzAwLCJjb2xvciI6IiNmZmZmZmYiLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEuMiwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6InJpZ2h0IiwidmVydGljYWwiOiJtaWRkbGUifSwiYW5pbWF0aW9uIjp7InByZXNldCI6ImZhZGVJbiIsImRpcmVjdGlvbiI6ImxlZnQiLCJzdHlsZSI6IndvcmQifX0sImZpdCI6Im5vbmUiLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMDYsInkiOjAuMTM3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In0sImxlbmd0aCI6OC40Niwic3RhcnQiOjE1LjU0LCJ3aWR0aCI6MTAwMCwiaGVpZ2h0IjozMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA0OTIgNzlcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI0OTJcIiBoZWlnaHQ9XCI3OVwiIGZpbGw9XCIjZmZmZmZmXCIvPjwvc3ZnPiJ9LCJmaXQiOiJub25lIiwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLjIxLCJ5IjowLjA1MX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlTGVmdCJ9LCJsZW5ndGgiOjguNjIsIm9wYWNpdHkiOjAuOSwic3RhcnQiOjE1LjM4LCJ3aWR0aCI6NDkyLCJoZWlnaHQiOjc5fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgNTY1IDEwN1wiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjU2NVwiIGhlaWdodD1cIjEwN1wiIGZpbGw9XCIjMDAwMDAwXCIvPjwvc3ZnPiJ9LCJmaXQiOiJub25lIiwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLjE5LCJ5IjowLjEzOH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHRTbG93In0sImxlbmd0aCI6OC44LCJvcGFjaXR5IjowLjcsInN0YXJ0IjoxNS4yLCJ3aWR0aCI6NTY1LCJoZWlnaHQiOjEwN31dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vYnJlYWtpbmctbmV3cy1vdmVybGF5L3NlMmMyYjZvejFldDFpbmpwZHpsNmQwZy9zb3VyY2VfZmFkMDEzOGYud2VibSJ9LCJzdGFydCI6MTQsImxlbmd0aCI6MTAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwicG9zaXRpb24iOiJjZW50ZXIiLCJmaXQiOiJjb250YWluIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vYnJlYWtpbmctbmV3cy1vdmVybGF5L3NlMmMyYjZvejFldDFpbmpwZHpsNmQwZy9zb3VyY2VfZmE3M2Q2ZDYud2VibSJ9LCJvZmZzZXQiOnsieCI6MCwieSI6MH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwibGVuZ3RoIjoxMCwib3BhY2l0eSI6MC41LCJzdGFydCI6MTQsImZpdCI6ImNvbnRhaW4ifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFNUT1JZX0lNQUdFIH19In0sInN0YXJ0IjoxNCwibGVuZ3RoIjoxMCwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwib2Zmc2V0Ijp7IngiOjAsInkiOjB9LCJwb3NpdGlvbiI6ImNlbnRlciIsInNjYWxlIjoxLCJmaXQiOiJjb250YWluIiwid2lkdGgiOjIwNTYsImhlaWdodCI6MTIyN31dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7IENJVFkgfX0iLCJmb250Ijp7ImZhbWlseSI6IkpUVVNqSWcxX2k2dDhrQ0hLbTQ1eFc1cnlnYmk0OWMiLCJzaXplIjoxNTcsIndlaWdodCI6NzAwLCJjb2xvciI6IiMyYzJjMmMiLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEuMiwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0Ijoic2xpZGVJbiIsImRpcmVjdGlvbiI6ImxlZnQiLCJzdHlsZSI6ImNoYXJhY3RlciJ9fSwibGVuZ3RoIjo1Ljc4LCJmaXQiOiJub25lIiwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLjAwOSwieSI6LTAuMTY5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVSaWdodCJ9LCJzdGFydCI6OC40Nywid2lkdGgiOjg0NiwiaGVpZ2h0IjoyOTh9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJPTiBUSEUgR1JPVU5EIElOIiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6OTEsIndlaWdodCI6NTAwLCJjb2xvciI6IiNmZmZmZmYiLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEuMiwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0Ijoic2xpZGVJbiIsImRpcmVjdGlvbiI6InVwIiwic3R5bGUiOiJ3b3JkIn19LCJsZW5ndGgiOjUuNzIsImZpdCI6Im5vbmUiLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOi0wLjAzMywieSI6LTAuMDMxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVEb3duIiwib3V0Ijoic2xpZGVMZWZ0In0sInN0YXJ0Ijo4LjM0LCJ3aWR0aCI6OTkxLCJoZWlnaHQiOjk5fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9icmVha2luZy1uZXdzLW92ZXJsYXkvc2UyYzJiNm96MWV0MWluanBkemw2ZDBnL3NvdXJjZV83MDZlNGE4Ny53ZWJtIn0sImxlbmd0aCI6Ny42NSwib2Zmc2V0Ijp7IngiOi0wLjA0NTY4MTE2MjA1ODczMjUzLCJ5IjotMC4xMDYzNjI0MzE1NTYwMDM5Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwic2NhbGUiOjEsIm9wYWNpdHkiOjAuOCwic3RhcnQiOjcuODMsIndpZHRoIjoxMDA2LCJoZWlnaHQiOjM1MywiZml0IjoiY29udGFpbiJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2JyZWFraW5nLW5ld3Mtb3ZlcmxheS9zZTJjMmI2b3oxZXQxaW5qcGR6bDZkMGcvc291cmNlX2Y4MmE5MDIyLndlYm0ifSwib2Zmc2V0Ijp7IngiOjAsInkiOjB9LCJwb3NpdGlvbiI6ImNlbnRlciIsImxlbmd0aCI6OC42Niwic3RhcnQiOjcsInRyYW5zaXRpb24iOnsib3V0IjoiZmFkZSJ9LCJmaXQiOiJjb250YWluIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vYnJlYWtpbmctbmV3cy1vdmVybGF5L3NlMmMyYjZvejFldDFpbmpwZHpsNmQwZy9zb3VyY2VfZmE3M2Q2ZDYud2VibSJ9LCJvZmZzZXQiOnsieCI6MCwieSI6MH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwibGVuZ3RoIjoxMCwic3RhcnQiOjcsIm9wYWNpdHkiOjAuNSwiZml0IjoiY29udGFpbiJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgQ0lUWV9JTUFHRSB9fSJ9LCJsZW5ndGgiOjEwLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9LCJvZmZzZXQiOnsieCI6LTUuNTUxMTE1MTIzMTI1NzgzZS0xNywieSI6MH0sInBvc2l0aW9uIjoiY2VudGVyIiwiZWZmZWN0Ijoiem9vbUluU2xvdyIsInNjYWxlIjoxLCJzdGFydCI6NywiZml0IjoiY29udGFpbiIsIndpZHRoIjoyNDE3LCJoZWlnaHQiOjEzOTB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJUb2RheSdzIE5ld3MgVXBkYXRlIiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6NTAsIndlaWdodCI6NTAwLCJjb2xvciI6IiMwMDAwMDAiLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEuMiwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoiZmFkZUluIiwiZGlyZWN0aW9uIjoibGVmdCIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjAuODQsImZpdCI6Im5vbmUiLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOi0wLjE4MiwieSI6LTAuMTY4fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJsZW5ndGgiOjkuMTYsIndpZHRoIjo3MjksImhlaWdodCI6ODV9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2JyZWFraW5nLW5ld3Mtb3ZlcmxheS9zZTJjMmI2b3oxZXQxaW5qcGR6bDZkMGcvc291cmNlX2QzNTM1NGRjLndlYm0ifSwic3RhcnQiOjAsIm9mZnNldCI6eyJ4IjotMC4yMjEwODU1NzUxMzQzNzA4MywieSI6LTAuMDg0MTUzOTkyMjAxNDU2N30sInBvc2l0aW9uIjoiY2VudGVyIiwic2NhbGUiOjEsImxlbmd0aCI6MTAsImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6OTE0LCJoZWlnaHQiOjEyOH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Ik15IE1lZGlhIENvbXBhbnkiLCJmb250Ijp7ImZhbWlseSI6IkpUVVNqSWcxX2k2dDhrQ0hLbTQ1eFc1cnlnYmk0OWMiLCJzaXplIjo3NSwid2VpZ2h0Ijo3MDAsImNvbG9yIjoiI2ZmZmZmZiIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MS4yLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoibGVmdCIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQiLCJkaXJlY3Rpb24iOiJsZWZ0In19LCJzdGFydCI6MC4yNCwiZml0Ijoibm9uZSIsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6LTAuMTQ4LCJ5IjotMC4wNzl9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifSwibGVuZ3RoIjo5Ljc2LCJ3aWR0aCI6ODUyLCJoZWlnaHQiOjEwM31dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDY2MyA3OVwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjY2M1wiIGhlaWdodD1cIjc5XCIgZmlsbD1cIiNmZmZmZmZcIi8-PC9zdmc-In0sInN0YXJ0IjowLjQ4LCJmaXQiOiJub25lIiwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjotMC4yMTIsInkiOi0wLjE3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJsZW5ndGgiOjkuNTIsIm9wYWNpdHkiOjAuOSwid2lkdGgiOjY2MywiaGVpZ2h0Ijo3OX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDg2MCAxMDdcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI4NjBcIiBoZWlnaHQ9XCIxMDdcIiBmaWxsPVwiIzAwMDAwMFwiLz48L3N2Zz4ifSwic3RhcnQiOjAuMywiZml0Ijoibm9uZSIsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6LTAuMTYxLCJ5IjotMC4wODV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnRTbG93In0sImxlbmd0aCI6OS43LCJvcGFjaXR5IjowLjcsIndpZHRoIjo4NjAsImhlaWdodCI6MTA3fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9icmVha2luZy1uZXdzLW92ZXJsYXkvc2UyYzJiNm96MWV0MWluanBkemw2ZDBnL3NvdXJjZV8wMzU0NTMxNy53ZWJtIn0sIm9wYWNpdHkiOjEsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7fSwic3RhcnQiOjAsInNjYWxlIjoxLCJsZW5ndGgiOjEwLCJmaXQiOiJjb250YWluIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vYnJlYWtpbmctbmV3cy1vdmVybGF5L3NlMmMyYjZvejFldDFpbmpwZHpsNmQwZy9zb3VyY2VfZmE3M2Q2ZDYud2VibSJ9LCJvZmZzZXQiOnsieCI6MCwieSI6MH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwic3RhcnQiOjAsIm9wYWNpdHkiOjAuNiwibGVuZ3RoIjoxMCwiZml0IjoiY29udGFpbiJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSEVBRExJTkVfSU1BR0UgfX0ifSwic3RhcnQiOjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwiZWZmZWN0Ijoiem9vbUluIiwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9LCJzY2FsZSI6MSwibGVuZ3RoIjoxMCwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxOTMzLCJoZWlnaHQiOjEzMTB9XX1dLCJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly9mb250cy5nc3RhdGljLmNvbS9zL21vbnRzZXJyYXQvdjMxL0pUVVNqSWcxX2k2dDhrQ0hLbTQ1eFc1cnlnYmk0OWMudHRmIn1dfSwib3V0cHV0Ijp7ImZvcm1hdCI6Im1wNCIsInNpemUiOnsid2lkdGgiOjE5MjAsImhlaWdodCI6MTA4MH0sImRlc3RpbmF0aW9ucyI6W3sicHJvdmlkZXIiOiJzaG90c3RhY2sifV19LCJtZXJnZSI6W3siZmluZCI6IkNJVFkiLCJyZXBsYWNlIjoiU1lETkVZIn0seyJmaW5kIjoiU1RPUllfSU1BR0UiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2JyZWFraW5nLW5ld3Mtb3ZlcmxheS85OTgzZGU2MC1lOTkwLTQ1N2UtYjAyYS1lYzk5ODJlYmY5ZjYvc291cmNlLmpwZyJ9LHsiZmluZCI6IkNJVFlfSU1BR0UiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2JyZWFraW5nLW5ld3Mtb3ZlcmxheS9kMDM4ZTNhOC05YTNiLTRhZGItYTFmYS1iZjI0MmQ3ZmFjMDEvc291cmNlLmpwZyJ9LHsiZmluZCI6IkhFQURMSU5FX0lNQUdFIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9icmVha2luZy1uZXdzLW92ZXJsYXkvYTE1N2NlODktMDVhZi00YzZlLWFlNjItNjcyZjVmNDE2ZWUxL3NvdXJjZS5qcGcifV19
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/breaking-news-overlay-v2
## How to use this template as a workflow
1. Render it once with the JSON below to confirm the output.
2. Replace the values that change per row of data (merge fields or asset URLs).
3. Loop over your data (CSV, database, webhook payload) and send one render per row. Add a `callback` URL to the request so Shotstack notifies you when each video is ready instead of polling.
4. To keep the JSON out of your app, store it with the Templates endpoint and render by template ID with a `merge` array: https://shotstack.io/docs/guide/architecting-an-application/templates/
## Customise
This template has merge fields. Send a `merge` array with the request to replace them; do not edit the timeline JSON.
| Field | Default |
| --- | --- |
| `{{ CITY }}` | SYDNEY |
| `{{ STORY_IMAGE }}` | https://templates.shotstack.io/breaking-news-overlay/9983de60-e990-457e-b02a-ec9982ebf9f6/source.jpg |
| `{{ CITY_IMAGE }}` | https://templates.shotstack.io/breaking-news-overlay/d038e3a8-9a3b-4adb-a1fa-bf242d7fac01/source.jpg |
| `{{ HEADLINE_IMAGE }}` | https://templates.shotstack.io/breaking-news-overlay/a157ce89-05af-4c6e-ae62-672f5f416ee1/source.jpg |
## Template JSON
```json
{
"timeline": {
"soundtrack": {
"src": "https://templates.shotstack.io/breaking-news-overlay/7e99ebe8-7207-4b50-ae3d-c2c3132f88db/viosin.mp3",
"effect": "fadeOut"
},
"background": "#ffffff",
"tracks": [
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "On the Harbour",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 50,
"weight": 500,
"color": "#000000",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1.2,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "right",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"fit": "none",
"scale": 1,
"offset": {
"x": 0.06,
"y": 0.056
},
"position": "center",
"transition": {
"in": "slideRight"
},
"length": 8.5,
"start": 15.5,
"width": 1000,
"height": 300
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_fe48b506.webm"
},
"offset": {
"x": 0.1726668086191856,
"y": 0.137
},
"position": "center",
"length": 8.9,
"scale": 1,
"start": 15.1,
"fit": "contain",
"width": 907,
"height": 456
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "Boat Race",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 75,
"weight": 700,
"color": "#ffffff",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1.2,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "right",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"direction": "left",
"style": "word"
}
},
"fit": "none",
"scale": 1,
"offset": {
"x": 0.06,
"y": 0.137
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"length": 8.46,
"start": 15.54,
"width": 1000,
"height": 300
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"fit": "none",
"scale": 1,
"offset": {
"x": 0.21,
"y": 0.051
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"length": 8.62,
"opacity": 0.9,
"start": 15.38,
"width": 492,
"height": 79
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"fit": "none",
"scale": 1,
"offset": {
"x": 0.19,
"y": 0.138
},
"position": "center",
"transition": {
"in": "slideRightSlow"
},
"length": 8.8,
"opacity": 0.7,
"start": 15.2,
"width": 565,
"height": 107
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_fad0138f.webm"
},
"start": 14,
"length": 10,
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_fa73d6d6.webm"
},
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"transition": {
"in": "fade"
},
"length": 10,
"opacity": 0.5,
"start": 14,
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "image",
"src": "{{ STORY_IMAGE }}"
},
"start": 14,
"length": 10,
"transition": {
"in": "fade"
},
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"scale": 1,
"fit": "contain",
"width": 2056,
"height": 1227
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{ CITY }}",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 157,
"weight": 700,
"color": "#2c2c2c",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1.2,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
},
"animation": {
"preset": "slideIn",
"direction": "left",
"style": "character"
}
},
"length": 5.78,
"fit": "none",
"scale": 1,
"offset": {
"x": 0.009,
"y": -0.169
},
"position": "center",
"transition": {
"in": "slideLeft",
"out": "slideRight"
},
"start": 8.47,
"width": 846,
"height": 298
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "ON THE GROUND IN",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 91,
"weight": 500,
"color": "#ffffff",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1.2,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
},
"animation": {
"preset": "slideIn",
"direction": "up",
"style": "word"
}
},
"length": 5.72,
"fit": "none",
"scale": 1,
"offset": {
"x": -0.033,
"y": -0.031
},
"position": "center",
"transition": {
"in": "slideDown",
"out": "slideLeft"
},
"start": 8.34,
"width": 991,
"height": 99
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_706e4a87.webm"
},
"length": 7.65,
"offset": {
"x": -0.04568116205873253,
"y": -0.10636243155600392
},
"position": "center",
"scale": 1,
"opacity": 0.8,
"start": 7.83,
"width": 1006,
"height": 353,
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_f82a9022.webm"
},
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"length": 8.66,
"start": 7,
"transition": {
"out": "fade"
},
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_fa73d6d6.webm"
},
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"transition": {
"in": "fade"
},
"length": 10,
"start": 7,
"opacity": 0.5,
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "image",
"src": "{{ CITY_IMAGE }}"
},
"length": 10,
"transition": {
"in": "fade"
},
"offset": {
"x": -5.551115123125783e-17,
"y": 0
},
"position": "center",
"effect": "zoomInSlow",
"scale": 1,
"start": 7,
"fit": "contain",
"width": 2417,
"height": 1390
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "Today's News Update",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 50,
"weight": 500,
"color": "#000000",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1.2,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"direction": "left",
"style": "word"
}
},
"start": 0.84,
"fit": "none",
"scale": 1,
"offset": {
"x": -0.182,
"y": -0.168
},
"position": "center",
"transition": {
"in": "slideRight"
},
"length": 9.16,
"width": 729,
"height": 85
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_d35354dc.webm"
},
"start": 0,
"offset": {
"x": -0.22108557513437083,
"y": -0.0841539922014567
},
"position": "center",
"scale": 1,
"length": 10,
"fit": "contain",
"width": 914,
"height": 128
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "My Media Company",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 75,
"weight": 700,
"color": "#ffffff",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1.2,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word",
"direction": "left"
}
},
"start": 0.24,
"fit": "none",
"scale": 1,
"offset": {
"x": -0.148,
"y": -0.079
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"length": 9.76,
"width": 852,
"height": 103
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.48,
"fit": "none",
"scale": 1,
"offset": {
"x": -0.212,
"y": -0.17
},
"position": "center",
"transition": {
"in": "slideRight"
},
"length": 9.52,
"opacity": 0.9,
"width": 663,
"height": 79
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.3,
"fit": "none",
"scale": 1,
"offset": {
"x": -0.161,
"y": -0.085
},
"position": "center",
"transition": {
"in": "slideLeftSlow"
},
"length": 9.7,
"opacity": 0.7,
"width": 860,
"height": 107
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_03545317.webm"
},
"opacity": 1,
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"transition": {},
"start": 0,
"scale": 1,
"length": 10,
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/breaking-news-overlay/se2c2b6oz1et1injpdzl6d0g/source_fa73d6d6.webm"
},
"offset": {
"x": 0,
"y": 0
},
"position": "center",
"transition": {
"in": "fade"
},
"start": 0,
"opacity": 0.6,
"length": 10,
"fit": "contain"
}
]
},
{
"clips": [
{
"asset": {
"type": "image",
"src": "{{ HEADLINE_IMAGE }}"
},
"start": 0,
"offset": {
"x": 0,
"y": 0
},
"effect": "zoomIn",
"position": "center",
"transition": {
"in": "fade"
},
"scale": 1,
"length": 10,
"fit": "contain",
"width": 1933,
"height": 1310
}
]
}
],
"fonts": [
{
"src": "https://fonts.gstatic.com/s/montserrat/v31/JTUSjIg1_i6t8kCHKm45xW5rygbi49c.ttf"
}
]
},
"output": {
"format": "mp4",
"size": {
"width": 1920,
"height": 1080
},
"destinations": [
{
"provider": "shotstack"
}
]
},
"merge": [
{
"find": "CITY",
"replace": "SYDNEY"
},
{
"find": "STORY_IMAGE",
"replace": "https://templates.shotstack.io/breaking-news-overlay/9983de60-e990-457e-b02a-ec9982ebf9f6/source.jpg"
},
{
"find": "CITY_IMAGE",
"replace": "https://templates.shotstack.io/breaking-news-overlay/d038e3a8-9a3b-4adb-a1fa-bf242d7fac01/source.jpg"
},
{
"find": "HEADLINE_IMAGE",
"replace": "https://templates.shotstack.io/breaking-news-overlay/a157ce89-05af-4c6e-ae62-672f5f416ee1/source.jpg"
}
]
}
```
## 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