> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beyondwords.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Player settings

Once you've installed the BeyondWords player, you can customize its appearance and behavior through the **Distribution → Player → Settings** section of your project dashboard.

<Warning>
  Due to caching, it may take up to 5 minutes for player setting changes to take effect.
</Warning>

<CardGroup cols={2}>
  <Card title="Programmatic configuration" icon="js" href="/docs-and-guides/distribution/player/developer-guides/player-properties">
    All of these settings can be overridden programmatically using [player properties](/docs-and-guides/distribution/player/developer-guides/player-properties).
  </Card>

  <Card title="Player settings API" icon="code" href="/api-reference/player-settings/show">
    Read and update player settings via the API.
  </Card>
</CardGroup>

## General

### Player size

Control the overall size of the player interface:

* **Small**: Compact version for limited space
* **Standard** (default): Balanced size suitable for most websites
* **Large**: Expanded size with enhanced visibility

### Player widget

Enable or disable the floating mini-player widget that appears when scrolling away from the main player.

### Widget size

When the player widget is enabled, you can set its size:

* **Small**: Minimal floating player
* **Standard** (default): Medium-sized floating player
* **Large**: Prominent floating player

### Widget position

Choose where the floating widget appears on the screen:

* **Left**: Aligned to the left side of the viewport
* **Center**: Centered horizontally in the viewport
* **Right**: Aligned to the right side of the viewport

## Branding

### Logo

Upload a custom logo to display in the player.

* Limited to the Large player size
* Use PNG, JPG, or WebP format (max 10MB)
* Recommended dimensions: at least 300px × 300px

<Note>
  This setting only applies when using the Large player size.
</Note>

### Color theme

Choose the color scheme for your player:

* **System**: Adapts to the user's device settings (light/dark mode)
* **Light mode** (default): Always use light theme
* **Dark mode**: Always use dark theme

### Light mode colors

Customize colors for the light theme:

* **Background color**: The main player background (#F5F5F5 by default)
* **Icon color**: Color for player controls and icons (#000 by default)
* **Text color**: Color for text elements (#111 by default)

### Dark mode colors

Customize colors for the dark theme:

* **Background color**: The main player background (#000 by default)
* **Icon color**: Color for player controls and icons (#FFF by default)
* **Text color**: Color for text elements (#FFF by default)

### Call-to-action

Customize the text for the main player button (default: "Listen to this article")

### Include article title

Toggle whether to display the article title in the player.

<Note>
  This setting only applies when using the Large player size.
</Note>

### Intro / Outro / Outros in playlists

Upload a custom audio intro and/or outro (MP3 or WAV format, max. 50MB):

* **Intro**: Plays at the beginning of your audio, before any pre-roll ads. Useful for branded intros or disclaimers.
* **Outro**: Plays at the end of your audio, after any post-roll ads. Useful for calls-to-action or acknowledgments.

You can also control whether the outro plays after each item in a [playlist](/docs-and-guides/distribution/playlists) or after the last item only. Intros only play at the start of a playlist and are not repeated for each item.

<Tip>
  Configure intros and outros at the [access tier](/docs-and-guides/distribution/player/access-tiers) level to deliver different audio messages to different audiences.
</Tip>

## Controls

### Skipping

Choose how users can navigate through the audio:

* **Skip by paragraph**: Move forward or backward by logical segments of content
* **Skip by seconds**: Set a specific time jump (e.g., 15 seconds) for skipping

## Interactions

### Continuous playback

If you enable continuous playback, the BeyondWords Player will automatically play your most recently published audios/videos after the current one finishes, from newest to oldest, without repeating the original item.

### Highlight paragraphs / words

* **Highlight paragraphs**: Enable this feature to highlight the paragraph that’s currently being read aloud in your article, to help users follow along
* **Highlight words**: Enable this feature to highlight the individual word that’s currently being read aloud in your article, to help users follow along

You can set a highlight colors for light mode and dark mode.

We recommend using the same color for words and paragraphs, with some transparency applied to the paragraph color (e.g., word color `#A4FF00`, paragraph color `#A4FF0044`). Make sure both provide sufficient contrast with your text color.

### Playback from paragraphs

Allow users to click or tap on any paragraph to begin playback from that point, boosting engagement with your content.

### Allow downloads

Enable listeners to download the audio from the player for offline listening.

## Save your settings

After configuring your player settings, click **Save changes** to apply them. Your settings will be applied to all instances of the player using your project ID.

## FAQs

<AccordionGroup>
  <Accordion title="Does the intro play when the user uses playback from paragraphs?">
    Yes, the intro will play if the user starts playback from a paragraph.
  </Accordion>

  <Accordion title="What's the difference between the main player and the widget?">
    The main player is embedded at the `target` element in your page. The **player widget** is a floating mini-player that appears when users scroll past the main player, keeping playback accessible. Configure widget size and position in the **Player widget** and **Widget position** settings above.
  </Accordion>

  <Accordion title="Can I use continuous playback instead of a playlist?">
    Yes. [Continuous playback](#continuous-playback) automatically plays your most recently published content after the current item ends. Use [playlists](/docs-and-guides/distribution/playlists) when you want a fixed or rule-based collection instead.
  </Accordion>

  <Accordion title="Why aren't my player setting changes appearing?">
    After you update player settings and click **Save changes**, it may take up for 5 minutes for the updates to take effect, due to caching.

    If you don't see your updates right away, wait 5 minutes then hard refresh the page before [troubleshooting](/docs-and-guides/support/troubleshooting) further.
  </Accordion>
</AccordionGroup>