🎨

Text Watermark

Add a customisable text watermark to an image

GET 10 credits /v1/image/watermark/text

curl "https://image.toolkitapi.io/v1/image/watermark/text?url=https://toolkitapi.io/static/samples/sample-image.png&text=%C2%A9%202024%20MyBrand&position=bottom-right&font_size=48&color=%23ffffff&opacity=0.5"

import httpx

resp = httpx.get(
    "https://image.toolkitapi.io/v1/image/watermark/text?url=https://toolkitapi.io/static/samples/sample-image.png&text=%C2%A9%202024%20MyBrand&position=bottom-right&font_size=48&color=%23ffffff&opacity=0.5",
)
print(resp.json())

const resp = await fetch("https://image.toolkitapi.io/v1/image/watermark/text?url=https://toolkitapi.io/static/samples/sample-image.png&text=%C2%A9%202024%20MyBrand&position=bottom-right&font_size=48&color=%23ffffff&opacity=0.5", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "image": "/9j/4AAQSkZJRgABAQ...(base64 data)...",
  "format": "png",
  "position": "bottom-right"
}

Try It Live

Live Demo

Response

Description

Add a customisable text watermark to an image

How to Use

1

1. Provide the source image via the `url` query parameter.

2

2. Set the `text` to overlay (max 200 characters).

3

3. Configure `position`, `font_size`, `color` (hex), and `opacity` (0.0–1.0).

4

4. The response contains the watermarked image as base64.

About This Tool

Use the Text Watermark endpoint to overlay custom text onto any image with full control over position, font size, colour, and opacity. The text is rendered on a transparent overlay and alpha-composited onto the image for a professional result.

This is essential for copyright protection, brand attribution, and proof-of-concept watermarking. Five position presets (top-left, top-right, bottom-left, bottom-right, center) with automatic margin handling make placement effortless.

Why Use This Tool

Brand attribution — Stamp your brand name on marketing images
Proof watermarks — Mark draft or preview images before client approval
Social media — Add captions or credit text directly on images
Legal compliance — Add required attribution text to licensed images

Frequently Asked Questions

Can I use custom fonts?

The endpoint uses the system default font scaled to your specified `font_size`. Custom font uploads are not currently supported.

How do I make a subtle watermark?

Set `opacity` to 0.2–0.4 for a barely visible watermark that's still detectable. Use a lighter colour like #ffffff on dark images or #000000 on light images.

What happens if the text is wider than the image?

Long text may extend beyond the image edges. Keep your watermark text concise or reduce the `font_size` for longer strings.

Start using Text Watermark now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs