# Post with Watermark

Protect your creative content and reinforce your brand by automatically applying watermarks to photos and videos you share across your social accounts.

### Overview

A watermark is a logo or symbol placed on your media to discourage unauthorized use and promote your brand. With Publer, you can save, manage, and apply unique watermarks per account—no editing skills required.

Watermarking is available on the **Professional Plan** for images and the **Business Plan** for videos.

### Step 1: Fetch Available Watermarks

Use the [Media Options endpoint](/docs/posting/create-posts/media-options.md) to get all saved watermarks for your account(s):

**Response Example:**

```json
[
  {
    "id": "63c675b54e299e9cf2b667ea",
    "albums": [],
    "watermarks": [
      {
        "id": "680fa7bebd7195d33da6630d",
        "name": "Brand Logo",
        "opacity": 80,
        "size": 6,
        "position": "bottom_right",
        "default": true,
        "image": "https://cdn.example.com/watermarks/logo.png"
      }
    ]
  }
]
```

* Each watermark is account-specific.
* You can create and manage multiple watermarks per account in Publer.

### Step 2: Schedule or Publish a Post with a Watermark

When creating or scheduling a post, specify the full `watermark` object in the relevant `accounts` array. The watermark settings will be applied to all attached media.

**Example Request:**

```json
{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "video",
            "text": "Watermark posts",
            "media": [
              {
                "id": "67da8532075cdb33821384c4",
                "name": "Follow your dreams.mp4",
                "path": "https://cdn.example.com/videos/67da8532075cdb33821384c4.mp4",
                "type": "video"
              }
            ],
            "details": {
              "type": "reel"
            }
          }
        },
        "accounts": [
          {
            "id": "63c675b54e299e9cf2b667ea",
            "scheduled_at": "2025-08-02T10:16:00+02:00",
            "watermark": {
              "id": "680fa7bebd7195d33da6630d",
              "name": "Brand Logo",
              "opacity": 80,
              "size": 6,
              "position": "bottom_right",
              "default": true,
              "image": "https://cdn.example.com/watermarks/logo.png"
            }
          }
        ]
      }
    ]
  }
}
```

### Parameters

<table><thead><tr><th width="237.20751953125">Field</th><th width="85.81573486328125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>accounts[].id</code></td><td>string</td><td>Target account ID</td></tr><tr><td><code>accounts[].scheduled_at</code></td><td>string</td><td>ISO 8601 timestamp for scheduling (omit for immediate publish)</td></tr><tr><td><code>accounts[].watermark</code></td><td>object</td><td>Watermark object to apply (see below)</td></tr><tr><td><code>watermark.id</code></td><td>string</td><td>Watermark ID (from fetched media options)</td></tr><tr><td><code>watermark.name</code></td><td>string</td><td>Watermark label</td></tr><tr><td><code>watermark.opacity</code></td><td>number</td><td>Opacity (0–100, higher = more opaque)</td></tr><tr><td><code>watermark.size</code></td><td>number</td><td>Relative size percentage (e.g., 6 = 6% of media size)</td></tr><tr><td><code>watermark.position</code></td><td>string</td><td>Position on media (<code>bottom_right</code>, <code>top_left</code>, etc.)</td></tr><tr><td><code>watermark.default</code></td><td>boolean</td><td>Whether this is the default watermark</td></tr><tr><td><code>watermark.image</code></td><td>string</td><td>URL to the watermark image (PNG recommended)</td></tr></tbody></table>

### Best Practices

* Use PNG logos with transparent backgrounds for cleaner results.
* Place watermarks in corners with moderate opacity to protect without distracting.
* Watermarking is available per account and per post—choose the right watermark for each audience.

### Key Notes & Limitations

* **Plan Requirements**: Watermarking images requires the Professional Plan, videos require the Business Plan.
* **Unlimited Media**: No limit on the number of photos you can watermark per post.
* **Account-specific**: Watermarks are managed and applied per account.
* **Media Orientation**: Watermarks are applied consistently regardless of image/video orientation.

### Related Topics

* [Media Options](https://github.com/copilot/c/posts-media-options.md)
* [Media Handling](https://github.com/copilot/c/posts-media-handling.md)
* [Publishing Methods](https://github.com/copilot/c/posts-publishing-methods.md)


---

# 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://publer.com/docs/posting/create-posts/content-types/post-with-watermark.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.
