Read the following guide to learn about the Player Studio player setup and customization settings menu.
Access the player edit view
To learn how to access the Player's edit view, please see The Kaltura Player Studio Edit View.
The player settings tab
The Player settings tab is the opening tab and is denoted by a gear icon.
This tab allows you to set playback options, player settings, bottom, and top bar capabilities, and interactive capabilities.
Playback options
Autoplay
- Choose whether to enable Autoplay (start playback automatically).
- If you enable Autoplay, choose whether to start playback automatically only when the player is in view. If a player is not in view, playback will start only when the viewer scrolls to it.
Start playback muted
Choose whether the video starts in mute mode when playback begins.
Autopause
Choose whether the video will pause automatically when the player scrolls out of view. Playback will resume when the player comes back into view.
Fallback to muted autoplay
Choose whether the video starts in mute mode when autoplay playback begins.
Preload
Choose whether to automatically load the video when the page loads.
Capabilities
Captions default display
You can choose whether to have captions display on the player by default when the user starts playing the video. Click the gear icon to open the caption settings:
Display captions - Check the box to enable.
Default language
Choose the default captions language - Auto or Manual.
- Auto - Will use the user-set preferences from local storage, browser language, or the default language.
- Manual - Requires entering a language code.
If you choose Manual, choose the desired language.
Captions alignment
Set default alignment of captions on the player:
- Default - captions will be displayed as received without any adjustments to alignment
- Left - captions will be aligned to the left
- Center - captions will be centered
- Right - captions will be aligned to the right
For the user manual, see Captions and Audio Tracks.
Share & Embed
Use the Share & Embed feature to allow users to share and embed the media via social websites and email.
If you choose to enable this feature, additional options display:
- Share url - Type the share URL that will override the current page sharing. If desired, you can add {entryId} to the address, for example: https://mycompanymediaspace.com/media/{entryId}, and the link updates according to the entry ID of the video being played.
- Embed url - This URL generates a link that dynamically updates based on the entry ID of the video being played. Type the embed URL in the following format:
{embedBaseUrl}/p/{partnerId}/embedPlaykitJs/uiconf_id/{uiConfId}?iframeembed=true&entry_id={entryId} - Share clip - This enables the user to share a segment of a video by choosing Share clip and then selecting the start and end position of the segment they want to share.
- Start at - This enables the user to share the link and initiate playback at the designated time.
- Use native share - Choose whether the native share dialog of the device is used.
- Social networks - You can define included networks, such as Facebook, LinkedIn, X (formerly Twitter), email, and embed.
For the user manual, see Share & Embed.
Info
Choose whether to enable an Information button in the upper right corner of the player. When a user clicks on the Information button, additional information about the video is displayed. For the user manual, see Info.
For the user manual, see Info.
Download
Choose whether to allow downloading of the entry media (i.e., source media) (in additional flavor(s)), captions, and/or files that are attached to the entries (i.e., attachments).
Choose which assets are available for users to download. Check the desired boxes to allow each download.
- Source media - Allow downloading of the entry media.
- Additional flavors - Allow users to select the quality of the media they would like to download.
- Captions - Allow users to download captions files attached to the media.
- Attachments - Allow users to download files attached to the media.
All boxes are checked by default.
If all boxes are unchecked, the Download plugin will be disabled by the player.
For the user manual, see Download.
Moderation
- Choose whether to enable a Moderation button in the upper right corner of the player. A user can click on this button to report content for various reasons, such as being sexually explicit, violent, or copywritten. If you choose to enable Moderation, additional options display.
- In Moderation reasons, choose the options from which the user can choose when reporting content - Sexual Content, Violent or Repulsive, Harmful or Dangerous Act, Spam/Commercials, Copyright Violation, or Terms of Use Violation.
- Optional - to custom the moderation reasons, go to Advanced Settings and edit the moderateOptions labels.
For the user manual, see Moderation.
Transcript
Choose whether to enable a transcript on the video. If you choose to enable transcript, additional options display:
- Position - Choose the position of the transcript - Right, Left, Top, or Bottom.
- Expand - Choose whether to expand the transcript alongside the video or over the video.
- Expand on First Play - Choose whether to expand the playlist side panel on the first play of the video.
- Show time - Choose whether to enable time markers to be added to the transcript.
- Download transcript enabled - Choose whether to allow the users to download the transcript.
- Print transcript enabled - Choose whether to allow the users to print the transcript.
For the user manual, see Transcript.
Call to Action
Interact directly with your audience using the Call to Action plugin. Configure interactive messages in your video which can be shown as overlays or toasts with clickable buttons. Make announcements, guide users to more content, invite them to contact you, and more, all directly from the player. Multiple CTAs can be added to each player, named sequentially as Call to Action 1, Call to Action 2, and so on.
If you choose to enable Call to Action, additional options display:
Type - Choose one of the following options:
- Overlay - The CTA displays across the entire player, pausing the video until the specified 'Hide after' duration elapses.
- Toast - The CTA appears at the bottom right corner of the player, allowing playback to continue for the specified 'Hide after' duration.
Hide After - Check the box to enable. Enter the desired duration in seconds for the CTA message.
If left blank, the CTA will remain until the user closes it.
Title - Type a title for the CTA message.
Description - Type your message.
Button - Enable/disable the button by clicking the box. If enabled, provide the following information:
- Label - Enter the text that will appear on the button.
- URL - Input the link that the button will direct the user to.
Secondary button - Click the box to add a secondary button.
Position - Choose from the following options:
- Start (enabled by default) - CTA will appear at the start of video playback.
- Time from start (in seconds) - Enter a time in seconds from the start of playback until CTA appears.
If the start position is greater than the video length, the CTA will not be displayed.
- Time from end - Enter a time in seconds counting back from the end of the video when the CTA should appear.
- End - Click the box to enable.
If left empty, the CTA will be displayed until closed out by the user.
If the CTA duration exceeds the video length, it will be displayed until the end of the video.
Delete Call to Action - Click to delete the CTA. A message displays: “Are you sure you want to permanently delete this CTA?”. Click Delete.
+ Add call to action - Click to add additional CTAs.
Only one CTA configuration can be opened at once. When clicking to open a specific CTA, the rest will be minimized.
The CTA text and design (font family, font size, font color, button shape, button color etc.) can be customized with external CSS. The default color is the player primary color.
For the user manual, see Call to Action.
Floating
Choose whether a floating player appears when the viewer scrolls the player out of view. This keeps the video accessible while allowing engagement with other content. If you opt for the floating player, click the arrow next to Floating for more options.
- Choose where to display the floating player: Top Right, Bottom Right, Top Left, or Bottom Left.
- Choose player behavior:
- Dismissible - choose whether the viewer can dismiss the floating player so that it doesn't display while they scroll the page. Users can dismiss the floating video by clicking 'Back to video' to return to the main player, or by clicking the 'X' icon to close the floating player.
- Draggable - choose whether the viewer may drag the floating player. When unchecked, the floating player has a fixed location.
- Choose dimensions and margins:
- Width - type the width of the floating player in pixels.
- Height - type the height of the floating player in pixels.
- Margin-X - type the margin, in pixels, from the selected edge, on the X-Axis.
- Margin-Y - type the margin, in pixels, from the selected edge, on the Y-Axis.
For the user manual, see Floating.
Skip intro/outro
Choose whether a pop-up skip control display allows viewers to skip certain content segments. This is useful in skipping intros and end credits, for example. If you choose to enable this feature, additional options display to set default values for the Intro and Outro durations. These default values will be used on all entries that are played on the player.
- Intro duration - the Intro will start at the beginning of the video and last the duration you set.
- Outro duration - the outro will start at the time counting back from the end of the video. For example, if the video is one minute long and you set the Outro duration to 10 seconds, the outro will begin at the 50-second mark in your video.
These default values will be overridden if an entry has an intro and/or outro configured in its metadata.
- Hide skip control - type the duration of time (in seconds) before the skip control is automatically hidden from view.
For the user manual, see Skip Intro/Outro.
Prevent seek
The Prevent seek plugin allows you adjust seeking capabilities of the player.
Prevent forward seek - allows you to prevent seeking forward beyond the maximum current seek time.
Prevent seek - allows you to prevent seeking completely (both backwards and forwards).
If the plugin is enabled, when hovering over the scrubber, thumbnails and chapters do not display on the timeline, nor do any other cue points.
For the user manual, see Prevent forward seeking.
Ad Blocker Detection
The Ad Blocker Detection plugin detects ad blockers enabled on users' devices.
Choose whether to enable ad blocker. If you choose to enable ad blocker, additional options display.
- Allow playback - Choose to allow playback with an ad blocker on. When the Ad Blocker Detection plugin detects an ad blocker, a message displays to the user giving them the choice to disable the ad blocker or keep it on. They may then continue playback.
Applicable to Allow playback only: Detection is performed just once at the beginning of a browser session, therefore, if a user enables ad blocker in the said browser tab after the one-time detection is performed, Ad Blocker Detection will not display a subsequent message to the user.
- Block playback - Choose not to allow playback with an ad blocker on. When the Ad Blocker Detection plugin detects an ad blocker, a message displays to the user informing them they must disable ad blocker in order to continue playback.
- Add custom overlay message - A default message is displayed to viewers for whom an ad blocker was detected. You may customize this message. Check to customize the overlay message, thereby overriding the default message.
- Title - Type a title for your custom overlay message.
- Description - Type a description for your custom overlay message.
- Close without disabling ad blocker - If you are allowing playback with an ad blocker on, you may type a label for the button users will click to signal they want to continue playback with an ad blocker on.
- Close after disabling ad blocker - Type a label for the button users will click to confirm they've disabled their ad blocker.
For the user manual, see Ad Blocker Detection.
Live
Choose whether to enable live streaming on the player. If you choose to enable this feature, additional options are displayed:
Pre broadcast slate - Add an image or video before a live broadcast has started.
- Entry - Insert a video or image entry ID. Entry will be broadcasted in a loop until the live stream starts. (By default, the entry thumbnail image is used as a background image for this slate.)
- URL - Image only. Insert an image URL that will be displayed until the live broadcast begins. A post slate image or video will play after the live broadcast ends. (By default, the entry thumbnail image is used as a background image for this slate.)
Pre broadcast slate - Add an image or video after the live broadcast has ended.
- Entry - Insert a video or image entry ID. Entry will be broadcasted in a loop after the live stream ends.
- URL - Image only. Insert an image URL that will be displayed after the live broadcast has ended.
For the user manual, see Live.
360 & VR
360 & VR lets you specify whether the player should support 360 and VR. This menu item also lets you configure its behavior for playing spherical 360 videos and immersive VR mode.
Select whether to enable this feature. If you choose to enable this feature, additional options display:
- Toggle Stereo - choose whether to show the Stereo Toggle button (relevant only to mobile devices).
- Start in Stereo Mode - choose whether to start the video in stereo mode.
- Move Multiplier - define the sensitivity of the mouse and touch movement by specifying the move multiplier.
- Device Motion Multiplier - define the sensitivity of the device motion.
Camera Options
- Camera frustum field of view - type camera frustum field of view.
- Camera frustum near plane - type camera frustum near plane.
- Camera frustum far plane - type camera frustum far plane.
For the user manual, see 360 & VR.
Playlist
Select whether to enable Playlist. If you choose to enable Playlist, additional options display:
- Auto continue - choose whether to continue to the next item automatically.
- Loop - choose whether to play the playlist in a loop. When selected, the playlist will play automatically, even if Auto continue is not selected.
- Countdown - choose whether to show the countdown.
In the Duration field, type how long the countdown will display.
For the user manual, see Playlist.
Playlist side panel
- Choose whether to enable a playlist side panel in the player. If you choose to enable a playlist side panel, additional options display.
- In Position, choose the position of the playlist side panel - Right, Left, Top, or Bottom.
- In Expand, choose whether to expand the playlist side panel alongside the video or over the video.
- In Expand on First Play, choose whether to expand the playlist side panel on the first play of the video.
For the user manual, see Playlist.
Related
- Choose whether the Related Videos screen is added to the end of the video to attract users to watch other videos. If you choose to enable the Related Videos Screen, additional options are displayed.
- In Auto continue after, choose whether the next item is automatically played.
- Type the time to wait before playing the next item (in seconds).
- In Display when playback is paused, choose whether the Related Videos Screen is displayed when playback is paused.
- Choose the source for the related entries - Related to Entry, Playlist ID, or Entries List.
- Related to Entry - Entries related to the current entry will be displayed. If there are no related entries, the plugin is disabled.
- Playlist ID - Select the desired playlist.
- Entries List - Type a comma-delimited list of entries.
For the user manual, see Related.
Navigation
- Choose whether to display navigation in the player. Navigation allows the user to search the video and click on and view specific times in the video.
- In Position, choose the position of the navigation - Right, Left, Top, or Bottom.
- In Expand, choose whether to expand the navigation alongside the video or over the video.
- In Expand on First Play, choose whether to expand the transcript on the first play of the video.
For the user manual, see Navigation.
Download
Choose whether to allow users to download the video for a media entry hosted by Kaltura.
- Click on the right of the toggle to enable.
- Click on the left of the toggle to disable.
The default setting is to have download disabled.
For the user manual, see Download.
Quiz
Enable this option to allow quiz creation on the player, launching quizzes within the video.
For the user manual, see Quiz.
Hotspots
Enable this option to allow hotspot creation on the player.
To learn more about hotspots, see Hotspots. To learn how to create and edit hotspots, see Kaltura Video Editing Tools - Hotspots Tab.
Dual screen
- Choose whether to enable dual screen on the player. When enabled, additional options display.
- In the Default layout, choose Picture in picture, Side by Side, or Single Media.
- In the Position of Picture in picture, choose Top Right, Bottom Right, Top Left, or Bottom Left.
For the user manual, see Dual Screen.
Live Q&A
- Choose whether to enable live Q&A in the video.
- In Position, choose the position of the live Q&A - Right, Left, Top, or Bottom.
- In Expand, choose whether to expand the live Q&A alongside the video or over the video.
- In Expand on First Play, choose whether to expand the live Q&A on the first play of the video.
For the user manual, see Live Q&A.
Documents
Choose whether to enable document entry support on the Kaltura Player. When enabled, if a document has been loaded in a Kaltura player (for example, as part of a playlist), a slate will appear instructing the user how to view the document.
Allow download - Check the box to enable document download when a document is not available for viewing.
For the user manual, see Documents.
Image playback
Choose whether to support image playback. For full APIs see Image player usage guide.
General
Localization
- Click the gear next to Localization to display configuration options. (You may also hover over Localization and click on the display arrow.)
- In Languages, select all languages to be bundled with the player.
- In Default Player Language, select the default language for the player.
Default player ratio
Set the default ratio (width and height) of the player. The values that are set will be used in player embed codes that are generated by embedding tools such as the KMC share & embed tool, and the player share & embed plugin.
- Click the gear icon next to Default player ratio to display the configuration options.
- Insert the preferred width (in pixels)
- Insert the preferred height (in pixels)
Apply user preferences
Select whether to use the user-set preferences from local storage, session storage, or based on the browser's language or default language, or other specified preferences.
When the Apply user preferences setting is enabled, the player first looks for saved preferences in local storage and applies them if found. If this setting is disabled, the player will ignore saved preferences and instead use the uiconf definitions or fallback defaults.
User preferences saved in local storage
User-configured settings (for example, starting playback in mute) are stored in the browser's local storage and persist across sessions. These preferences ensure users can retain their last-used settings for a consistent playback experience. For example, if the last played media was muted, the next media will begin muted also, even if the user refreshed the page.
The following values are saved in local storage:
- Muted
- Volume
- Audio language track
- Text language track (i.e., captions)
- Captions text style (for example, font size and color)
- Audio flavor (the last selected audio track, including audio description (AD) tracks)
User preferences saved in session storage
Session storage is temporary and only persists while the browser session is active. Once the session ends, the settings are cleared. For example, if a user sets the playback speed to x2, it will reset to the default speed (normally x1) the next time they visit the site.
The following value is saved in session storage:
- speed control
Mobile screen lock orientation
- Choose whether to enable Mobile Screen Lock Orientation.
- If you enable Mobile Screen Lock Orientation, select the default screen lock orientation for the player when in full screen - None, Any, Natural, Landscape, Portrait, Portrait primary, Portrait secondary, Landscape primary, or Landscape secondary.
Keep Player on Current Version [Version Number]
Choose whether to prevent the player from automatically updating when a new version becomes available.
Updating the player to the latest version will uncheck the "Keep on Current Version [xx]" radio button in the Studio.
Note: It’s highly recommended that you update to the latest version of the player, as it includes the newest fixes and improvements of the player.
Advanced Settings
Edit your player’s configuration file using advanced settings. Recommended only for advanced player developers.
For the next Player Settings guide, please visit The Kaltura Player Studio Admin Guide - Visual Tab.