---
title: "Configure a watermark"
slug: "configure-a-watermark"
abstract: "How to configure a watermark."
---
# Configure a watermark

In Sitecore Content Hub, a default [watermark](https://doc.sitecore.com/ch/en/users/content-hub/watermarking.html "Watermarking") is added for users who only have access to watermarked content. The format of this watermark is: *username MM/DD/YY hh/mm +UTC AM/PM*.

> [!note]
> To configure Content Hub, you must either be a superuser or have the necessary permissions granted to you through [user group policies](https://doc.sitecore.com/ch/en/users/content-hub/user-group-policies.html "User group policies").

You can edit the default watermark, or you can create and edit additional watermarks as needed. A watermark can include static text, dynamic text from variables, and an optional background image if required.

> [!note]
> To preview an asset from its details page, you need to configure both a document watermark and an image watermark. This is because the preview functionality uses an image, but the [Deep Zoom feature](https://doc.sitecore.com/ch/en/users/content-hub/preview-an-asset.html "Preview an asset"), which lets you zoom on an inline preview, uses a PDF.

> [!tip]
> For an example of how to configure watermark settings, see [Set up watermark permissions](https://doc.sitecore.com/ch/en/users/content-hub/set-up-watermark-permissions.html "Set up watermark permissions").

To configure a watermark:

1. On the menu bar, click **Manage** :mdiCogOutline:.
2. On the **Manage** page, click **Watermarks**.
3. On the **Watermarks** page, click **\+ Watermark**.
4. In the **Watermark** dialog, click the type of watermark you want to create:
    - **Document watermark** - to add a watermark to a PDF document.
    - **Image watermark** - to add a watermark to an image asset.
5. In the **Document watermark** or **Image watermark** dialog, fill out the following fields.

    | Field | Description | Mandatory |
    | --- | --- | --- |
    | **Name** | Name of the watermark. | Yes |
    | **Watermark format** | A string consisting of static text and dynamic variables, which defines the wording of the watermark. This string has a maximum length of 60 characters, and all variable names are case-sensitive. A valid example is **{User} viewed {Title} on {Date}**, where:<br><br><ul><li>**{User}** returns the current user.</li><li>**{Title}** returns the asset title.</li><li>**{Date}** returns the date and time when the content was requested, depending on the chosen **Date format**.</li></ul><br><br>Valid watermark format values are:<br><br><ul><li>String values - **{1}** returns an error.</li><li>Single values - **{user Title}** returns an error.</li><li>Non-multilingual values. Only primary culture properties are supported.</li></ul> | No |
    | **Rendition links** | List of renditions on which to apply the watermark. | No |
    | **Text color (HEX)** | Hex color code for the watermark text. Either the full (#FFFFFF) or the short (#fff) code is valid. | Yes |
    | **Text size (px)** | Size of the watermark text. | Yes |
    | **Date format** | A valid datetime format to apply to date and time variables in the watermark. | No |
    | **Angle (deg)** | Counter-clockwise rotation of the watermark text, in degrees. | No |
    | **Opacity (%)** (Style) | Opacity percentage of the watermark text. | Yes |
    | **Offset (X%,Y%)** | Relative offset of the X and Y axis of the watermark. | Yes |
    | **Image URL** | URL of the watermark background image, if required. | No |
    | **Margin (%)** | Margin before the background image. | Yes |
    | **Opacity** (Background image) | Opacity percentage of the watermark background image. | Yes |
    | **Position** | Position of the background image | Yes |

6. Click **Save**.