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

# Image watermarking

Cloudimage can place a watermark on top of your images if you want to protect them from copying or tag them with a serial number or custom text. There are three types of watermarks - click on each one for more details.

Most of the on-the-fly image transformations can be configured using the [Asset Variation Builder](/transformations/asset-variation-builder.md), an in-line URL  builder to preview each image transformation instantly.

| <p><a data-mention href="/pages/7qO2BNUSggrFIAbOvIli">/pages/7qO2BNUSggrFIAbOvIli</a></p><p><br>Apply the same image watermark to all the images you decide to watermark (e.g. your company's logo).</p>       | ![](/files/9fcnfaWIOkjESwATRcCQ) |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| <p><a data-mention href="/pages/gw9dSLe02bS5iUhqbqXT">/pages/gw9dSLe02bS5iUhqbqXT</a></p><p><br>Specify the watermark in the Cloudimage URL to apply different watermarks to different images.</p>             | ![](/files/qA7LkJrli1JIr8hRdggQ) |
| <p><a data-mention href="/pages/JM94OrgPW0SHtccrmNsC">/pages/JM94OrgPW0SHtccrmNsC</a></p><p><br>If you need to tag images, use the text watermark to dynamically embed text to the images you need tagged.</p> | ![](/files/8E7ZayyGFTZVz7BBkcur) |

## Multiple watermarks

### Basic syntax

You can overlay multiple watermarks by indexing the parameters in the URL **wat\[1]=1**&**wat\[2]=1**. The **wat=1** parameter must be indexed and contain all watermarks to activate the feature.&#x20;

All parameters without indices will be applied to all watermarks in the image.

?<mark style="color:purple;">**wat\[1]=1**</mark>&<mark style="color:purple;">**wat\[2]=1**</mark>&<mark style="color:purple;">**wat\_scale\[1]=50**</mark>&<mark style="color:purple;">**wat\_scale\[2]=10**</mark>&<mark style="color:purple;">**wat\_opacity=0.5**</mark>

In the above fragment, **wat\_opacity=0.5** will be applied to both watermarks.

### Multiple watermark types

Combining multiple watermark types is also possible.

{% hint style="info" %}
Remember that the presence of the **wat\_url=X** parameter defines a dynamic watermark, **wat\_text=X** defines a text watermark and the absence of either defines a static watermark.
{% endhint %}

?<mark style="color:purple;">**wat\[**</mark><mark style="color:red;">**1**</mark><mark style="color:purple;">**]=1**</mark>&<mark style="color:purple;">**wat\[**</mark><mark style="color:red;">**2**</mark><mark style="color:purple;">**]=1**</mark>&<mark style="color:purple;">**wat\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**]=1**</mark>&<mark style="color:purple;">**wat\_url\[**</mark><mark style="color:red;">**2**</mark><mark style="color:purple;">**]=sample.li/Angular.png**</mark>&<mark style="color:purple;">**wat\_text\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**]=text**</mark>

In the above fragment, there are three watermarks. Watermark 2 is a dynamic watermark, watermark 3 is a text watermark, and watermark 1 is a static one.

### Example

| Preview                          | Syntax                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ![](/files/yAJCcGIIoruaYlMMvAsY) | [/samples.scaleflex.com/paris-salon2.jpg?<mark style="color:orange;">**w=600**</mark>&<mark style="color:purple;">**wat\[**</mark><mark style="color:red;">**1**</mark><mark style="color:purple;">**\]=1**</mark>&<mark style="color:purple;">**wat\[**</mark><mark style="color:red;">**2**</mark><mark style="color:purple;">**\]=1**</mark>&<mark style="color:purple;">**wat\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**\]=1**</mark>&<mark style="color:purple;">**wat\_pad=6**</mark>&<mark style="color:purple;">**wat\_url\[**</mark><mark style="color:red;">**1**</mark><mark style="color:purple;">**\]=http://sample.li/Angular.png**</mark>&<mark style="color:purple;">**wat\_url\[**</mark><mark style="color:red;">**2**</mark><mark style="color:purple;">**\]=http://sample.li/React.png**</mark>&<mark style="color:purple;">**wat\_gravity\[**</mark><mark style="color:red;">**1**</mark><mark style="color:purple;">**\]=southeast**</mark>&<mark style="color:purple;">**wat\_gravity\[**</mark><mark style="color:red;">**2**</mark><mark style="color:purple;">**\]=southwest**</mark>&<mark style="color:purple;">**wat\_scale=25**</mark>&<mark style="color:purple;">**wat\_text\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**\]=TEXT%20WATERMARK**</mark>&<mark style="color:purple;">**wat\_fontsize\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**\]=20**</mark>&<mark style="color:purple;">**wat\_gravity\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**\]=north**</mark>&<mark style="color:purple;">**wat\_color\[**</mark><mark style="color:red;">**3**</mark><mark style="color:purple;">**\]=blue**</mark>](https://doc.cloudimg.io/https://samples.scaleflex.com/paris-salon2.jpg?w=600\&wat\[1]=1\&wat\[2]=1\&wat\[3]=1\&wat_pad=6\&wat_url\[1]=http://sample.li/Angular.png\&wat_url\[2]=http://sample.li/React.png\&wat_gravity\[1]=southeast\&wat_gravity\[2]=southwest\&wat_scale=25\&wat_text\[3]=TEXT%20WATERMARK\&wat_fontsize\[3]=20\&wat_gravity\[3]=north\&wat_color\[3]=blue) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cloudimage.io/transformations/image-watermarking.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.