> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HTML/CSS to Image

> HTML/CSS to Image converts HTML, CSS, public web pages, and reusable templates into images and PDFs through an API.

![HTML/CSS to Image logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/htmlcss_to_image.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=d9fdaeaf4046db14b5d8f17615b664fb)

* **Category:** images & design
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `HTMLCSS_TO_IMAGE`
* **Version:** 20261030\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Create Image
>
> **Slug:** `HTMLCSS_TO_IMAGE_CREATE_IMAGE`
>
> Create a hosted image from HTML/CSS or an internet-reachable webpage, including authenticated pages using request headers. Returns an image ID and a hosted URL accessible to anyone who has that URL.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.014 per image rendered; cached renders may be free.
>
> **Discount:** 79
>
> #### Input Parameters
>
> **css** `string`
>
> CSS applied to supplied HTML or injected into a captured webpage.
>
> **url** `string`
>
> Absolute, internet-reachable HTTP(S) webpage URL to capture. Set this or html, but not both; use headers for authenticated pages.
>
> **html** `string`
>
> HTML to render. Set this or url, but not both.
>
> **headers** `object`
>
> HTTP headers sent to the captured page, with at most 20 case-insensitive names.
>
> **ms\_delay** `integer`
>
> Extra render delay in milliseconds, from 0 to 10000. Zero omits the explicit delay.
>
> **selector** `string`
>
> CSS selector for the element to capture.
>
> **timezone** `string`
>
> IANA timezone exposed to the rendered page.
>
> **media\_type** `string ("screen" | "print")`
>
> CSS media type used while rendering: screen or print.
>
> **full\_screen** `boolean`
>
> Capture the full scrollable page instead of only the viewport.
>
> **max\_wait\_ms** `integer`
>
> Maximum wait from 500 to 10000 milliseconds for page loading.
>
> **color\_scheme** `string ("light" | "dark")`
>
> Preferred browser color scheme: light or dark.
>
> **device\_scale** `number`
>
> Device scale factor from 0.1 to 3.
>
> **google\_fonts** `array`
>
> Google Font family names to load while rendering.
>
> **viewport\_width** `integer`
>
> Viewport width in pixels, from 1 to 6000. Requires viewport\_height.
>
> **viewport\_height** `integer`
>
> Viewport height in pixels. Requires viewport\_width.
>
> **dedupe\_duration\_s** `integer`
>
> Reuse a matching recent render for this many seconds. Allowed durations depend on the account plan; free accounts accept 0 or 2592000 (30 days).
>
> **render\_when\_ready** `boolean`
>
> Wait until the page signals that rendering is ready.
>
> **block\_consent\_banners** `boolean`
>
> Attempt to block common consent banners.
>
> **transparent\_background** `boolean`
>
> Render a transparent background where supported.
>
> **additional\_header\_origins** `array`
>
> Up to 20 unique exact HTTP(S) origins that may also receive headers.
>
> **include\_headers\_on\_subrequests** `boolean`
>
> Also include supplied headers on page subrequests.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Image from Template
>
> **Slug:** `HTMLCSS_TO_IMAGE_CREATE_IMAGE_FROM_TEMPLATE`
>
> Create an image from a reusable template using the latest version or an explicitly selected version.
>
> #### Input Parameters
>
> **template\_id** `string` *required*
>
> Template ID from LIST\_TEMPLATES or CREATE\_TEMPLATE.
>
> **template\_values** `object` *required*
>
> Values supplied to the template's Handlebars variables.
>
> **template\_version** `integer`
>
> Specific version to render; omit to use the latest version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Images Batch
>
> **Slug:** `HTMLCSS_TO_IMAGE_CREATE_IMAGES_BATCH`
>
> Create 1 to 25 hosted images from HTML/CSS or internet-reachable webpages in one request, including authenticated pages using shared or per-image headers. Requires an account plan that supports batch creation.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.014 per image rendered; cached renders may be free.
>
> **Discount:** 79
>
> #### Input Parameters
>
> **variations** `array` *required*
>
> One to 25 image requests; each overrides matching default\_options fields.
>
> **default\_options** `object`
>
> Shared render settings applied before each variation's overrides.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Template
>
> **Slug:** `HTMLCSS_TO_IMAGE_CREATE_TEMPLATE`
>
> Create a reusable Handlebars HTML/CSS image template. WARNING: the template is persistent because the API exposes no delete operation, and a free account can hold only one template.
>
> #### Input Parameters
>
> **css** `string`
>
> CSS applied to the template.
>
> **html** `string` *required*
>
> Handlebars HTML for the reusable template.
>
> **name** `string`
>
> Template name, at most 64 characters.
>
> **description** `string`
>
> Template description, at most 1024 characters.
>
> **render\_options** `object`
>
> Optional free-tier render settings for this template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Image
>
> **Slug:** `HTMLCSS_TO_IMAGE_DELETE_IMAGE`
>
> Permanently delete one generated image and clear its HCTI CDN cache. Copies previously written to external storage are not deleted.
>
> #### Input Parameters
>
> **image\_id** `string` *required*
>
> Image ID to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Images Batch
>
> **Slug:** `HTMLCSS_TO_IMAGE_DELETE_IMAGES_BATCH`
>
> Permanently delete multiple generated images and clear their HCTI CDN caches. Copies previously written to external storage are not deleted.
>
> #### Input Parameters
>
> **image\_ids** `array` *required*
>
> Non-empty list of image IDs to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get or Transform Image
>
> **Slug:** `HTMLCSS_TO_IMAGE_GET_IMAGE`
>
> Download a generated image by ID, optionally converting its format, resizing it, or cropping it.
>
> #### Input Parameters
>
> **dpi** `integer`
>
> Output DPI from 30 to 600, primarily for PDF output.
>
> **width** `integer`
>
> Output width in pixels, up to 5000.
>
> **format** `string ("png" | "jpg" | "webp" | "pdf")`
>
> Output file format. Defaults to PNG when omitted.
>
> **height** `integer`
>
> Output height in pixels, up to 5000.
>
> **crop\_top** `string`
>
> Top crop coordinate or percentage.
>
> **image\_id** `string` *required*
>
> Generated image ID returned by an image creation tool.
>
> **x\_origin** `string ("start" | "center" | "end")`
>
> Horizontal origin used for aspect-ratio cropping.
>
> **y\_origin** `string ("start" | "center" | "end")`
>
> Vertical origin used for aspect-ratio cropping.
>
> **crop\_left** `string`
>
> Left crop coordinate or percentage.
>
> **crop\_right** `string`
>
> Right crop coordinate or percentage.
>
> **crop\_width** `string`
>
> Crop width as a pixel coordinate or percentage.
>
> **crop\_bottom** `string`
>
> Bottom crop coordinate or percentage.
>
> **crop\_height** `string`
>
> Crop height as a pixel coordinate or percentage.
>
> **aspect\_ratio** `string`
>
> Crop aspect ratio in width\_height form, such as 16\_9.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Usage
>
> **Slug:** `HTMLCSS_TO_IMAGE_GET_USAGE`
>
> Return recent hourly, daily, monthly, and billing-period image usage for the connected account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Templates
>
> **Slug:** `HTMLCSS_TO_IMAGE_LIST_TEMPLATES`
>
> List reusable image templates owned by the connected account, including their current version, source, and render settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Template
>
> **Slug:** `HTMLCSS_TO_IMAGE_UPDATE_TEMPLATE`
>
> Create a new version of an existing template using replacement Handlebars HTML and optional CSS or render settings.
>
> #### Input Parameters
>
> **css** `string`
>
> CSS for the new template version.
>
> **html** `string` *required*
>
> Replacement Handlebars HTML for the new template version.
>
> **name** `string`
>
> Template name, at most 64 characters.
>
> **description** `string`
>
> Template description, at most 1024 characters.
>
> **template\_id** `string` *required*
>
> Existing template ID from LIST\_TEMPLATES or CREATE\_TEMPLATE.
>
> **render\_options** `object`
>
> Optional free-tier render settings for the new template version.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
