HTML/CSS to Image API

It's easy to generate images just from some simple HTML

With this HTML you can generate a screenshot from any public Facebook post. This uses the Facebook embed code. Simply swap the link in the HTML with the link to a Facebook post and it will show it. Take note of the selector and ms-delay params. They must be set correctly for this image to render nicely.

Example code

Make changes to the code and click the Image button below

            <div id="fb-root"></div>
<script async defer crossorigin="anonymous" src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v11.0" nonce="SOhYrMAR"></script>

<!-- See data-href below. Replace that with the link to your Facebook post -->
<!-- set ms_delay: 2500 to give it extra time toload -->
<!-- set selector: .fb-post -->
<div class="fb-post" data-href="https://www.facebook.com/HermanMiller/photos/a.171562157561/10158261466927562" data-width="500" data-show-text="true"></div>

          

Advanced options

Use these settings to tweak your image even further. See our docs for full details on all the available options.

url Pass a publically available URL and the API will screenshot it. This overrides any HTML.

google_fonts Google fonts to be loaded. Example: Roboto. Multiple fonts can be loaded like this: Roboto|Open Sans. You must also set the font-family in your CSS to use the loaded font.

device_scale Adjusts the pixel ratio for the screenshot. The default is 2 which is equivalent to a 4K monitor. Minimum: 1, Maximum: 3

Image size + cropping

Images are automatically cropped by default. We crop to the outermost HTML element. For extra tweaking, use these settings

viewport_width Set the width of Chrome's viewport. This will disable automatic cropping. Both height and width parameters must be set if using either.

viewport_height Set the height of Chrome’s viewport. This will disable automatic cropping. Both height and width parameters must be set if using either.

selector Advanced: A CSS selector for an element in the HTML. We’ll crop the image to this specific element.

Timing

By default the API generates a screenshot once everything is loaded. If the page executes JavaScript, you may want extra time before the image is rendered.

ms_delay Adds extra time for JavaScript to execute. Use this if you're seeing a blank image and are using JavaScript. Default: 0. Start with 500 if needed.

render_when_ready
Set to true to control when the image is generated. Call ScreenshotReady() from JavaScript in your code to trigger the image generation. Learn more.

Live

re-generate image Loading

How does HTML/CSS to Image work?

We run your HTML/CSS in a specialized instance of Google Chrome so that it renders exactly how you'd expect it to. Then we generate a screenshot from Chrome, crop it for you automatically and give you back a performance optimized URL to your image.

You can then use this URL anyway you'd like. You can download the image and host it somewhere else. Or directly use the URL in your apps and webpages.

We've spent years on this problem and our API generates millions of images each month. We continually improve it as people find new ways to use the API