> ## Documentation Index
> Fetch the complete documentation index at: https://docs.img-processing.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Watermark Image
> Apply a watermark to an image.
IMG Processing allows you to apply watermarks to images. This is useful for adding a logo or a text to an image, or for adding a
copyright notice.
Despite the name, watermarks are just overlay images that are placed on top of the original image, making more flexible
than traditional watermarks.
In this guide, we'll see how to apply a watermark to an image using the API.
## Uploading our Watermark
The first step is to create our watermark image. For this, we'll use the `upload` endpoint.
Upload an image to the API
First, download the image you want to use as a watermark. Here we'll use the IMG Processing logo.
Then, copy your api key on the dashboard and replace it on the `x-api-key` field, and replace the `image` field with the path to the image you want to use as a watermark.
```bash theme={null}
curl -X POST "https://api.img-processing.com/v1/images" \
-H "x-api-key: YOUR_API_KEY" \
-F "image=@logo.png" \
-F "name=watermark-logo"
```
This will return an image object with the watermark image.
```json theme={null}
{
"id":"image_za9vcdw6yajjyg77v5kkf3bn",
"name":"watermark-logo",
"url":null,
"width":1515,
"height":1505,
"format":"png",
"size":1939304,
"created_at":"2025-04-01T16:52:32.503Z"
}
```
Now, we have our watermark image created, and we can apply it to an image.
## Uploading our Image
The next step is to upload the image we want to apply the watermark to. For this, we'll use the `upload` endpoint again.
This time, we'll use the following image:
```bash theme={null}
curl -X POST "https://api.img-processing.com/v1/images" \
-H "x-api-key: YOUR_API_KEY" \
-F "image=@cat2.png" \
-F "name=cat-image"
```
This will return an image object with the image we want to apply the watermark to.
```json theme={null}
{
"id":"image_iv7d1rish0ymrmk7qwuht3ap",
"name":"cat-image",
"url":null,
"width":1024,
"height":1024,
"format":"png",
"size":1427326,
"created_at":"2025-04-01T16:15:44.212Z"
}
```
Now, we have our watermark image and our image created, and we can apply the watermark to the image.
## Applying the Watermark
To apply the watermark to the image, we'll use the `watermark` endpoint.
Apply a watermark to an image
As parameters, we need to send the image id of the image we want to apply the watermark to.
```
https://api.img-processing.com/v1/images/{imageId}/watermark
```
As body, we need to send the watermark image inside the `watermarks` array.
```json theme={null}
{
"watermarks": [
{
"id": "image_za9vcdw6yajjyg77v5kkf3bn",
"top": 100,
"left": 100,
"width": 200,
"height": 200
}
]
}
```
Here is an example request:
```bash theme={null}
curl -X POST "https://api.img-processing.com/v1/images/image_iv7d1rish0ymrmk7qwuht3ap/watermark" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"watermarks": [
{
"id": "image_za9vcdw6yajjyg77v5kkf3bn",
"top": 100,
"left": 100,
"width": 200,
"height": 200
}
]
}'
```
This will return an image object with the watermark applied to the image.
```json theme={null}
{
"id":"image_idl1ad5ppzbq65qohwbtcdjc",
"name":"cat-image",
"url":null,
"width":1024,
"height":1024,
"format":"png",
"size":1430284,
"created_at":"2025-04-01T17:02:58.496Z"
}
```
## Downloading the Image
Now, we have our image with the watermark applied to it, and we can download it using the `download` endpoint.
Download an image
```bash theme={null}
curl -X GET "https://api.img-processing.com/v1/images/YOUR_IMAGE_ID/download" \
-H "x-api-key: YOUR_API_KEY" \
-o "cat-image-removed-background.png"
```
This will download the image to your computer.
## Try it yourself
You can try this on the Postman collection.
Try it yourself on the Postman Collection
## Keep Learning
Now that you know how to apply a watermark to an image, you can learn how to do other things with the API.
* [Set a repetition mode to the watermark](/api-reference/endpoints/multi-image/watermark#param-repetition-mode) to make the watermark repeat across the image.