Skip to main content
Once you’ve installed the BeyondWords player, you can customize its appearance and behavior through the Distribution → Player → Settings section of your project dashboard.

Programmatic configuration

All of these settings can be overridden programmatically using player properties.

Player settings API

Read and update player settings via the API.

​
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

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
This setting only applies when using the Large player size.

​
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.
This setting only applies when using the Large player size.

​
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 or after the last item only. Intros only play at the start of a playlist and are not repeated for each item.
Configure intros and outros at the access tier level to deliver different audio messages to different audiences.

​
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

Yes, the intro will play if the user starts playback from a paragraph.
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.
Yes. Continuous playback automatically plays your most recently published content after the current item ends. Use playlists when you want a fixed or rule-based collection instead.