> ## Documentation Index
> Fetch the complete documentation index at: https://burger-bot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# /watermark

> Apply a professional watermark to any image — full control over position, size, opacity, padding, shadow, and outline.

Apply a watermark to any image with full control over position, size, opacity, padding, shadow, and outline.

## Description

Upload an image and an optional watermark (or text), and Burger Bot returns a watermarked version. The watermark is **automatically scaled** based on the dimensions of the uploaded image so it always looks balanced.

## Required permissions

* **User:** none
* **Bot:** `Embed Links`, `Attach Files`

## Syntax

```text theme={null}
/watermark image:<file> watermark:<text or image>
  [position:<value>] [size:<value>] [opacity:<value>]
  [padding:<value>] [shadow:<on|off>] [outline:<on|off>]
```

## Example

```text theme={null}
/watermark image:<photo.png> watermark:Burger Bot
  position:bottom_right size:auto opacity:80 padding:auto shadow:on outline:on
```

## Options

<Tabs>
  <Tab title="Position">
    | Value           | Result                |
    | --------------- | --------------------- |
    | `top_left`      | Top-left corner       |
    | `top_center`    | Top edge, centered    |
    | `top_right`     | Top-right corner      |
    | `center_left`   | Middle, left edge     |
    | `center`        | Dead center           |
    | `center_right`  | Middle, right edge    |
    | `bottom_left`   | Bottom-left corner    |
    | `bottom_center` | Bottom edge, centered |
    | `bottom_right`  | Bottom-right corner   |
  </Tab>

  <Tab title="Size">
    | Value    | Result                                 |
    | -------- | -------------------------------------- |
    | `auto`   | Scales with image dimensions (default) |
    | `small`  | Small watermark                        |
    | `medium` | Medium watermark                       |
    | `large`  | Large watermark                        |
  </Tab>

  <Tab title="Opacity">
    | Value      | Result                         |
    | ---------- | ------------------------------ |
    | `10`–`100` | Watermark opacity in 10% steps |

    Choose `10`, `20`, `30`, `40`, `50`, `60`, `70`, `80`, `90`, or `100`.
  </Tab>

  <Tab title="Padding">
    | Value  | Result                                 |
    | ------ | -------------------------------------- |
    | `auto` | Scales with image dimensions (default) |
    | `5`    | 5 pixels                               |
    | `10`   | 10 pixels                              |
    | `20`   | 20 pixels                              |
    | `30`   | 30 pixels                              |
    | `40`   | 40 pixels                              |
  </Tab>

  <Tab title="Shadow">
    | Value | Result                           |
    | ----- | -------------------------------- |
    | `on`  | Drop shadow behind the watermark |
    | `off` | No shadow (default)              |
  </Tab>

  <Tab title="Outline">
    | Value | Result                       |
    | ----- | ---------------------------- |
    | `on`  | Outline around the watermark |
    | `off` | No outline (default)         |
  </Tab>
</Tabs>

## Notes

<Tip>
  When in doubt, leave `size:auto` and `padding:auto`. Burger Bot will automatically scale the watermark to the dimensions of the uploaded image so it looks balanced on any picture.
</Tip>

<Note>
  For readability on busy backgrounds, combine `shadow:on` and `outline:on` with `opacity:80` or higher.
</Note>