​
Player settings

Once you’ve installed the BeyondWords player, you can customize its appearance and behavior through various settings. This guide walks you through all available configuration options.

​
General settings

​
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

​
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.
  • Limited to Large player size

​
Intro

Add a custom audio clip to play at the beginning of your content:
  • Upload MP3 or WAV format (max 50MB)
  • Useful for branded intros or sponsorship messages

​
Outro

Add a custom audio clip to play at the end of your content:
  • Upload MP3 or WAV format (max 50MB)
  • Perfect for calls-to-action or acknowledgments

​
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

​
Highlight paragraphs

Enable this feature to highlight the paragraph that’s currently being read aloud, keeping users engaged with the content.

​
Highlight colors

  • Light mode highlight: Color used for highlighting in light mode (#A4FF00 by default)
  • Dark mode highlight: Color used for highlighting in dark mode (#A4FF00 by default)

​
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.

​
Saving your settings

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

Programmatic configuration

All these settings can also be configured programmatically when initializing the player. See the JavaScript SDK documentation for details.