> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/tools/image.md).

# Image

The **Image** tool allows you to manipulate and process images. By passing in an image URL, you can add image effects, overlays, identify colors, and remove backgrounds.

{% hint style="info" %}
Image is a Premium app. There is a limit to the number of Premium actions we provide for free. [Learn more](https://docs.getmesa.com/going-further/plans-and-billing#premium-steps)
{% endhint %}

## Add Effects / Transform your image

This action adds image effects to the supplied image. Pass in an image URL and then the action will return a new image URL that can be accessed using the `{{ image }}` [variable](/workflow-builder/fields/variables.md).

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FrFdVrCVqkGgDE5HxuEip%2FEF-image-improve-transform.png%20-%20Step%202.png?alt=media&amp;token=703a0832-c659-4ce1-b219-4b2fe9439b7f" alt="Screenshot of MESA Image tool Add Effects / Transform action configuration. Spotlight the Image URL field and the image effect options."><figcaption></figcaption></figure>

## Add an Overlay

This action adds a text overlay or a watermark to the supplied image. You can either pass an image URL for the watermark or configure the text overlay. The Trigger will return a new image URL that can be accessed using the `{{ image }}` [variable](/workflow-builder/fields/variables.md).

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FjlaZyYPOTu1eMkNGM95b%2FEF-image-add-text-overlay.png%20-%20Step%202.png?alt=media&amp;token=f4cf15b9-36f0-4ba1-8304-100e9374cd1b" alt="Screenshot of MESA Image tool Add an Overlay action configuration. Spotlight the text overlay and watermark fields."><figcaption></figcaption></figure>

## Identify Colors

This action identifies the most predominant colors used in an image. Simply pass an image URL to the trigger, and it will return a list of the colors in the form of the `{{ colors }}` [variable](/workflow-builder/fields/variables.md).

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FNoT7iB9EdtVh3e1lJwMG%2FEF-image-identifying-colors.png%20-%20Step%202.png?alt=media&amp;token=870530d9-22c9-4cd9-a1d1-5525de9f1957" alt="Screenshot of MESA Image tool Identify Colors action configuration. Spotlight the Image URL field used to return the colors variable."><figcaption></figcaption></figure>

## Technical Notes

The Image tool is a premium app and has a boundary to the number of times it can be executed each billing period.