> 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

Edit images in a MESA workflow with the Image tool, adding effects and overlays, detecting colors and removing backgrounds from an image URL.

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.

:::note
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)
:::

## 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](https://docs.getmesa.com/workflow-builder/fields/variables/).

<figure><img src="https://docs.getmesa.com/assets/EF-image-improve-transform.png%20-%20Step%202.png" 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](https://docs.getmesa.com/workflow-builder/fields/variables/).

<figure><img src="https://docs.getmesa.com/assets/EF-image-add-text-overlay.png%20-%20Step%202.png" 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](https://docs.getmesa.com/workflow-builder/fields/variables/).

<figure><img src="https://docs.getmesa.com/assets/EF-image-identifying-colors.png%20-%20Step%202.png" 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.