TypeScript icon, indicating that this package has built-in type declarations

1.2.0 • Public • Published

Creatomate Preview SDK

The Preview SDK lets you display video and image previews in your web app prior to creating a final MP4, GIF, JPEG or PNG through the API. This is useful when developing a web-based editing or customizer tool, and want to show a real-time rendering in the browser.

This package is for browser-based apps, and it works with any framework such as React, Angular, Vue, as well as plain Javascript. For creating videos and images using Node.js, refer to the creatomate library instead, a different NPM package that can be found here.

Creatomate is a media generation API for editing and rendering videos and images using code. The platform uses templates and JSON for generating MP4, GIF, JPEG or PNG files. All processing is handled by Creatomate's cloud infrastructure, so you do not need to maintain your own servers.



Install the package using the following command:

npm install @creatomate/preview

You can now load a video template (or JSON) as follows:

import { Preview } from '@creatomate/preview';

// The following assumes that you have a HTML element like this: <div id="container"></div>
const containerElement = document.getElementById('container');

// Initialize a preview to be spawned within the container
const preview = new Preview(containerElement, 'player', 'YOUR_VIDEO_PLAYER_TOKEN');

// Once the SDK is ready, load a template from the project
preview.onReady = async () => {
  await preview.loadTemplate('YOUR_TEMPLATE_ID');
  // You can also load a video from JSON:
  // await preview.setSource({ /* Your JSON here */ });

Check out the demo code provided below for a more comprehensive example.


See the Preview SDK in action here: Video Preview Demo

Issues & Comments

Feel free to contact us if you encounter any issues with the library or Creatomate API at support@creatomate.com.


The Creatomate Preview SDK is licensed under the MIT license. Please refer to the LICENSE for more information.




Package Sidebar


Weekly Downloads






Unpacked Size

63.7 kB

Total Files


Last publish


  • casperkloppenburg