> For the complete documentation index, see [llms.txt](https://docs.3q.video/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.3q.video/user-guide-new-ui/players.md).

# Players

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

Players define **how media is presented and played back**. They control the UI, behavior, features, security, and sharing options for videos, playlists, podcasts, and live streams.

{% hint style="info" %}
Changes made to an existing player configuration are applied automatically wherever this player is already embedded. You do not need to copy or replace the embed code again after updating player settings.
{% endhint %}

From the **Players** module, you can centrally manage all player configurations. Using our [**Player SDK**](broken://pages/x4eD1BmEFwkorOtoo10X) is recommended when working with a large number of videos or when you want to tightly integrate the player with your frontend and control it via methods and events. The player automatically fetches the configured settings from our backend. If needed, you can override specific parameters by passing them to the SDK during initialization.

***

### **Player overview**

The **Players** view lists all available players with:

* **Title**
* **Project scope**: Global or project-specific
* **Description**
* **Creation date**

You can search, sort, and switch between **All Players**, **Global Players**, and **Project-Specific Players**.

***

**Create & manage players**

Click **Create Player** to define a new player configuration. Players can be:

* **Global** – available across all projects
* **Project-specific** – restricted to a single project

One player can be marked as the **default player** for a project or globally.

The player name is shown in the player overview and in the playout management of projects. The optional description helps identify the purpose of the player configuration.

{% hint style="info" %}
If a player is assigned to a specific project, it is used for that project’s playouts. If no dedicated project-specific player is assigned, the global or default player configuration is used.
{% endhint %}

***

#### Player settings

Player configuration is organized into clear sections.

<figure><img src="/files/V2TK2IzPkRieUp0ZjqMM" alt="" width="188"><figcaption></figcaption></figure>

**Basics**

Define general metadata and availability:

* **Title & Description**
* **UI language**
* **Project availability**
* **Default player** selection

***

**Settings**

Control playback behavior and appearance:

* **Accent color**
* **Autoplay options**: muted, scroll-based, etc.
* **Initial audio & subtitle language**
* **Initial video quality**
* Metadata display preferences
* End-of-playback behavior: loop, recommendations, continuous playback

***

### **Features**

{% hint style="info" %}
Some player settings only become effective if the corresponding module has been activated for the account. This applies, for example, to playlists, podcasts, advertising, live comments, Geo/IP blocking, and other optional features.
{% endhint %}

<table data-search="false"><thead><tr><th width="259.328125">Feature / setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>More Layout Settings</strong></td><td>Opens advanced UI detail settings for customizing the player layout.</td></tr><tr><td><strong>Prefer Container Metadata</strong></td><td>For playlists and podcasts, the player displays metadata from the active container instead of the active media element.</td></tr><tr><td><strong>Collect Analytics</strong></td><td>Enables GDPR-compliant analytics collection for media playback in real time.</td></tr><tr><td><strong>Trick-play</strong></td><td>Allows users to change the playback speed for on-demand media.</td></tr><tr><td><strong>Transcript Search</strong></td><td>Enables searchable transcripts. Users can search for text passages and jump directly to the matching playback position.</td></tr><tr><td><strong>Picture-in-Picture</strong></td><td>Allows the player to continue playback in a small floating window, if supported by the browser.</td></tr><tr><td><strong>Pop-out / Sticky Playback</strong></td><td>Keeps the player visible while the user scrolls by anchoring it on the page.</td></tr><tr><td><strong>Advertising</strong></td><td>Enables advertising support for the player. Advertising rules are managed separately.</td></tr><tr><td><strong>Sharing Services</strong></td><td>Defines which sharing options are available in the player, such as Facebook, LinkedIn, Reddit, WhatsApp, Bluesky, or others.</td></tr><tr><td><strong>Embed Code</strong></td><td>Allows users to generate an embed code directly from the player interface.</td></tr><tr><td><strong>Disable Timeshift</strong></td><td>Prevents users from scrolling back during a livestream, even if the stream itself supports timeshift.</td></tr><tr><td><strong>Live Comments</strong></td><td>Enables comments on live streams and displays comments from users.</td></tr><tr><td><strong>Live Reactions</strong></td><td>Allows users to send live reactions during an active livestream. Reactions can be disabled or shown in the sidebar or control bar.</td></tr><tr><td><strong>Playlist / Podcast Settings</strong></td><td>Contains settings for playlist and podcast playback behavior.</td></tr><tr><td><strong>Show Container Elements on Load</strong></td><td>Opens the list of active playlist or podcast elements when the container is loaded.</td></tr><tr><td><strong>Maximum Available Items</strong></td><td>Limits the number of playlist or podcast items available in the player.</td></tr><tr><td><strong>Automatic Shuffle</strong></td><td>Randomizes the playlist order each time the list is loaded.</td></tr><tr><td><strong>Reel Mode</strong></td><td>Displays playlist videos as reels and allows users to switch between active media items.</td></tr><tr><td><strong>Show Playlist Search</strong></td><td>Enables search within playlist or podcast elements during playback.</td></tr><tr><td><strong>Use Categories as Filters</strong></td><td>Uses assigned categories as filters inside the playlist or podcast element list.</td></tr><tr><td><strong>Muted Start</strong></td><td>Forces playback to always start muted, regardless of whether the user previously enabled audio manually.</td></tr><tr><td><strong>Force Audio Player</strong></td><td>Uses the player as an audio player, even when video content is played.</td></tr><tr><td><strong>SEO Optimization</strong></td><td>Adds microdata and JSON-LD metadata to make media information visible to search engines.</td></tr><tr><td><strong>Download of Current Media File</strong></td><td>Controls whether users can download the current media file, and whether downloads use the source file, a rendition, or both.</td></tr><tr><td><strong>Remote Playback</strong></td><td>Enables Chromecast or AirPlay playback if supported by the user’s device.</td></tr></tbody></table>

***

### **Security**

{% hint style="info" %}
We recommend protecting your player to ensure that only authorized users can access your content. For more information on integrating the player with token protection, please refer to our player documentation.
{% endhint %}

Protect your content with:

* **Token protection**

* **Domain restrictions**

* **AES encryption**

* **DRM**

* **Playback preview limits**

* **Geo/IP blocking templates**, if the module is enabled

***

#### Visual & playback enhancements

**Badges**

Badges are overlays permanently displayed on the player.

You can:

* Upload a badge image
* Choose the badge position
* Add titles or links
* Use badges for branding, labels, or visual markers

***

###


---

# 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.3q.video/user-guide-new-ui/players.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.