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

<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&#x26;token=703a0832-c659-4ce1-b219-4b2fe9439b7f" alt=""><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://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&#x26;token=f4cf15b9-36f0-4ba1-8304-100e9374cd1b" alt=""><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://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&#x26;token=870530d9-22c9-4cd9-a1d1-5525de9f1957" alt=""><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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getmesa.com/tools/image.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.