> For the complete documentation index, see [llms.txt](https://docs.podplay.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podplay.app/replays/watermarks-and-ads-on-replays.md).

# Watermarks & Ads on Replays

### Overview

PodPlay supports two on-Replay ad surfaces:

1. A watermark logo on Quick Replays
2. A logo on the Pre-roll and Post-roll before an Instant Replay

To enable any of these, upload them on the CMS page of the Dashboard.

{% hint style="info" %}
Replays are available to any Club on the Pro or Autonomous(+) Tier. Enhanced Replays require Pro Monitors with the PB Vision integration enabled.
{% endhint %}

### Quick Replay Watermark

The watermark logo appears at the bottom of every 25-second Quick Replay generated in the App. The logo is permanent: once the Replay is downloaded, texted, or posted to social media, the watermark goes with it. The logo can be placed in the bottom corners of the Quick Replay or in the bottom center.

{% hint style="success" %}
If you are a pickleball Club, the best positioning for your watermark and ad logo is in the bottom center. This accounts for any Customers cropping the video to upload to social media.
{% endhint %}

The Quick Replay watermark is environment-wide. Every Quick Replay generated in the App carries the same logo across every Club location.

<figure><img src="/files/JGo2z8pNOn5bZ9yFmGRy" alt=""><figcaption></figcaption></figure>

The CMS feature will eventually support multiple logos.

### Instant Replay Pre-roll and Post-Roll

This Pre-roll and Post-roll has a watermark on the swipescreen.

The Instant Replay watermark logo appears on the 3-second swipe animation that plays on the Scoreboard before the 10-second Instant Replay. The logo is visible during that 3-second swipe, then disappears when the Instant Replay itself begins.

The Instant Replay watermark is location-based. A multi-venue Club can run different watermark logos at different locations. For example, one logo at the New York City Club and a different logo at the Chicago Club. The CMS feature will eventually support multiple logos and video before the Instant Replay.

<div><figure><img src="/files/iqf4B3sf5Wud827QL4qZ" alt=""><figcaption></figcaption></figure> <figure><img src="/files/asT1DJ8qSZe9i4g1bgvY" alt=""><figcaption></figcaption></figure> <figure><img src="/files/RBV3FrJlwBGseaG5Xbtb" alt=""><figcaption></figcaption></figure></div>

### Scoreboard Sponsored Ad

The Scoreboard animation that crosses over the points before each Instant Replay can also display a Sponsored Ad at the bottom of the swipe. The animation runs for 3 seconds and is followed by the 10-second Instant Replay.

### Asset types

A Logo is a PNG or JPEG image overlaid on the Replay video, placed at a configurable position on the frame (bottom-right or bottom-center). Supported formats are `.png`, `.jpg`, and `.jpeg`. A Postroll is a short video appended to the end of the Replay clip. Supported formats are `.mp4`, `.mov`, and `.webm`.

#### Uploading assets

Assets upload to the CMS page of the Dashboard load to a shared library available to all Replay Servers in your environment.

1. Open any Replay Server and expand Advanced Settings.
2. Scroll to Upload to Library.
3. Drag and drop a file, or click to select one.
4. The file uploads and becomes available for selection.

#### Assigning assets to a device

Once an asset is uploaded, assign it to a specific device:

1. Open the Replay Server and expand Advanced Settings.
2. Under On Device, select a Logo from the dropdown.
3. Select a Postroll from the dropdown.
4. Choose the Placement position for the logo.
5. Click Save Settings. The configuration is pushed to the device immediately if it's online, or applied on the next heartbeat (about 5 minutes). Replays already generated before the change keep the old branding; only new Replays pick up the update.

#### Previewing on-device assets

To verify what's currently installed on a device:

* Click the eye icon next to Logo or Postroll to preview the asset directly from the device.
* Use Preview Branding at the bottom of Advanced Settings to generate a short branded Replay using the first enabled camera. To see the branding live in the Club, run a quick Replay on the device's monitor after the configuration has pushed.

#### Troubleshooting

**"Cannot reach device" when viewing on-device status:** The device may be offline or unreachable from the API server. Confirm it's connected and reporting heartbeats. **Logo or postroll not appearing in generated Replays:**

* Verify the assets are assigned and saved in Advanced Settings.
* Check that the asset files exist on the device using the eye-icon preview buttons.
* Restart the service if the configuration was changed recently.
* If a logo previews as blank or won't render, re-upload the image and confirm it appears in the preview before assigning it again.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.podplay.app/replays/watermarks-and-ads-on-replays.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
