Global

About

The AddNew module is used to add the +Create button located at the top right of the navigation bar. The +Create drop-down menu and its contents are configured in this module.

Check out our Create menu user guide!

Prerequisites

Enable the Theming module as well as the Header option within the module's features section.

Configure

Go to your Configuration Management page and click the AddNew module. You can also navigate directly using a link: https://{your_site_url}/admin/config/tab/addNew 

The AddNew page displays.

buttonDisplay - This field lets you choose whether to show or hide the +Create button for anonymous users. For logged-in users, the button is displayed based on their permissions to add media. Choose from the following options:

• Show for guests
• Hide for guests
• Do not show

Sections

Here you can control what tools to show in the +Create menu, and in which section of the menu. The +Create menu is split into three sections and allows you to promote the most used creation tools/apps to the top of the menu. You can also choose to have all the tools in one section if that works for you.

The checkboxes next to the menu items determine their placement in the menu. Unchecking an item does not remove it from the menu; it will appear instead in its default location (unless checked in a different section). To fully remove an item, disable its module (see below). 

Section 1

To place the most-used tools in the first section, check the boxes next to each one.

Section 2

To add additional tools under the heading Other Creation Tools, check the boxes next to the desired items in the second section.

Section 3

To add additional tools under the heading Collections, check the boxes next to the desired items in the third section. 

Modules

This section lists the modules that add items to the +Create menu.

Enable and configure modules by clicking the configure option on the right, which will take you directly to that module. Here are your options:

kwebcast - Enables Town Hall (webcasting) in the menu.

newrow - Adds Meeting Room to the menu.

recorder - Displays Express Capture in the menu.

quiz - Adds Video Quiz to the menu.

kalturacapture - Shows Capture in the menu.

onedrive - Adds oneDrive to the menu.

raptmedia - Displays Interactive Video in the menu.

youtube - Adds YouTube to the menu.

draft - Shows Draft Entry in the menu.

stitch - Adds Stitch Videos to the menu.

This is an example configuration:

The result is as follows:

About

The Application module allows you to manage the overall settings of your application and customize the features displayed in your environment. Here you can set the title of the application and adjust various entry-related features such as enabling likes, restricting editing and deleting entries, setting the default language, and configuring other display options.

Configure

1. Go to your Configuration Management console and click on the Application module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/application.

The Application page displays. 

2. Configure the following:

Preset fields

These values are set during installation and are read only.

instanceId - This is the unique string to identify an installation of Kaltura's Video Portal (aka MediaSpace). Can be used to differentiate the instance in the KMC analytics. 

privacyContext - This string is used to set as the privacy context on root category. The video portal root category must also be set with this value. 

userRoleProfile - This is the Metadata Profile ID for the user's role per video portal installation instance. 

virtualEventID - This is the event ID for this site, used for analytics and is a prerequisite for the Application Registry feature set (see below) and more. If empty, some instances may have a Generate Event ID button which you need to click to to enable it.  

Application registry 

Use the applicationRegistry to subscribe an application to various microservices, primarily Authbroker, but also others.

mainSiteAlias - Set the main site domain to be used in the Application Registry and AuthBroker modules (hostname only, no protocol, for example, “videos.kaltura.com“). Value should be completed automatically by the Event Platform Manager (EPM).

appRegistrationID - This is the application registry ID - a prerequisite for the Application Registry feature set (such as AuthBroker). If empty, some instances may have a Register App button which you need to click to to enable it.  

userProfile - This field indicates the use of the User Profile for registration. Application must be registered in order to use this field. The default value is "1" , and only a Kaltura administrator is authorized to modify it.

Set the title of the application

title - Enter the title of your site. This title is displayed in the browser's title bar and is usually displayed in search engine results. Page titles consist of the name of the currently loaded media and the site title, for example, if a page features a video named 'My Video' and 'MediaSpace' is the site title, the page title would be 'My Video - MediaSpace'.

Set the site's footer

footer - Enter the footer text. The default is 'MediaSpace video portal by Kaltura'.

Add JavaScript (JS) to your pages

The following fields may be used to insert JS on all video portal (non-admin) pages, either by adding the JS directly in the app admin, or using a link to a hosted JS file. Do not use these fields if you are unfamiliar with the JS inserted. 

headerJS - Enter any JS to be run on all video portal headers. Don't use if you're not familiar with the JS inserted. Will not work on admin pages.

headerJSlinks - Enter links to JS files to be loaded on all video portal headers. Do not use if you are not familiar with the JS inserted. Will not work on admin pages. 

1. Click +Add "headerJSlinks".
2. url -  Enter the full URL for the JS file (for example: https://myfiles.com/files/my.js).
   

bodyJS - Enter any JS to be run at the bottom of all video portal pages. Don't use this field if you're unfamiliar with the JS inserted. This field is not applicable to admin pages.

Set compatibility mode

forceIECompatibilityMode  - Set to 'Yes' if you want Internet Explorer to use the latest rendering engine even when Compatibility Mode is on. By default, when Compatibility Mode is on, Internet Explorer uses IE7's engine to render pages. Turning on this option makes Internet Explorer use the latest rendering engine instead. For more details, please visit the link.

Add a theme

theme - This field is only left for backward compatibility. Keep the value default if you are a new admin. If your instance is configured with the Theming Design System, please see the Theming module.

Set the UI language(s)

languageConfiguration - Configure your instance to enable users to select a different language or multiple languages for their user interface. All non-configurable text in the UI will be automatically translated. However, manually entered text, such as category names or entry titles, will remain unchanged.

To enable a single language, select Single Language Instance and choose the language from the language drop-down menu.

To enable multiple languages, select Multi Language Instance and choose the different languages you want to enable from the languageSelection menu (below).

languageSelection - Click the boxes next to the languages you want to display on the user interface.

showLanguageFlag - Select 'Yes' to show the available languages with the flag. Select 'No' to show the first 2 letters representing the language. 

language - Select the default language for new users. In the video portal, when users change the language from the dropdown menu, it will be saved on a persistent cookie. In KAF-based LMS, the language on Kaltura elements will match the language set by the user in the LMS settings.

User experience for Theming users

Enable "Likes" and displaying entry titles in the URL

enableLike - Set to 'Yes' to enable the 'Like' feature for entries.

enableEntryTitles - Set to 'Yes' to include the media title in the URL of the media page when browsing the site and sharing a link to the media.

Restrict editing or deleting published entries

If you're worried about accidental deletions or edits to published content, you can restrict these actions. Simply set the corresponding fields to "No" and save. This disables the Edit and Delete icons for published content.

allowEditPublished  -  Set to 'Yes' to enable editing of published entries.

allowDeletePublished - Set to 'Yes' to enable deletion of published entries.

enableEntryDelete - Set to 'Yes' to enable deleting media from your video portal. 

Configure display options

enableViews - Set to 'Yes' to enable displaying the number of views per entry. 

showPageTitles - Set to 'Yes' to display the page titles. Note that this feature applies only to specific pages and will not function on Theming pages.

showCreatedByIndicator - Set to 'Yes' to show the ‘Created By’ indication on the media page and in the global search.

enableUnlisted - Set to 'Yes' to enable setting entries as unlisted. An unlisted entry may be viewed by anyone with the link to the entry page but will not appear in any search results.

timezone - Choose which timezone your video portal should use to present times and dates. 

useUserTimezone - Set to 'Yes' to show webcast and scheduling time in the user's time zone.

Configure additional display options

assetConsolidationEnabled - Enable assets (js/css) consolidation and minification. Setting this field to 'Yes' will provide a faster load of the pages. Set to 'No' when looking to validate and investigate through the site's JS and CSS.

showEmailInUserSuggestions -  Set to 'Yes' to show the user's email address in the user suggestions box when searching for users.

enableLoadButton - When you enable this setting, a 'Load More' button will show up on list pages (like channels, galleries, My media, etc.) after displaying the initial set of results. This feature allows more entries to load instead of endless scrolling. Please note that this applies only to specific pages and will not work on theming pages, as they are configured with pagination.

Set the user management window display

extraUserInfoRow - Choose what column to show on the user management table.

• Show extra info  - displays the Extra Data column in the User Management window
• Show Registration Status - displays the Registration column in the User Management window

ssoDomains

Click +Add "ssoDomains" and enter the email domains for SSO users. SSO users are instructed to login using the SSO authentication method, and are not allowed to:

• Login through Kaltura login
• Register in the external registration form
• Use the forgot password flow

Supported formats: xxx.yyy or xxx.yyy.zzz (for example, “domain.com” or “sub.domain.com”) 

3. Click Save.

About

The Auth module manages user logins for the video portal. By default, it uses Kaltura Authentication. Please note:

• To switch to SAML authentication, check out the SAML module.
• For multiple authentication methods, use the 'enableMultiAuth' setting.
• To help users change their login method after selecting "Remember My Selection," they can visit: https://<partnerId>.mediaspace.kaltura.com/user/clear-login-selection or clear their browser cookies."

Authbroker

AuthBroker is a "gateway" that sits on the partner (account) level and manages authentication to Kaltura via external Identity providers (IdP). AuthBroker works with the Security Assertion Markup Language (SAML) and Open Authorization (OAuth 2.0) protocols. AuthBroker users are "shared users" (users who are shared between applications / instances in the partner).

AuthBroker works with a higher version of SAML and you no longer need to set up a new profile for each new account. You can set up profile(s) just once and easily use them in multiple applications/instances.

Configure

Go to your Configuration Management console, and navigate to the Auth module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/auth.

In the Auth module window, configure the following:

demoMode - Set to 'Yes' if you want to enable the demo login mode. After entering any user or password combination, the user has an admin role.

showLogin - Set to 'Yes' if you want to show login / logout menu on site header.

phUser - user ID alternate field placeholder

phPwd - password alternate field placeholder

phLoginInstruction - login instructions

enableMultiAuth 

enableMultiAuth set to 'No'

enableMultiAuth - Enable Multi-Authentication Methods configuration. If you leave the setting on 'No', complete the authNAdapter and authZAdapter fields below. If you select 'Yes', skip to the next section.

authNAdapter - What is the name of the PHP class for handling authentication? KalturaAuth enables the built-in User Management system (located at /admin/users).

 LdapAuth lets you use your organizational LDAP/AD server to authenticate users. To use your own custom class, enter the custom class name, then click 'Add custom value'.

The value is added to the menu.

authZAdapter - What is the name of the PHP class for handling authorization? Authorization determines the user's role. KalturaAuth enables the built-in User Management system (located at /admin/users). LdapAuth lets you use your organizational LDAP/AD server to determine roles. 

To use your own custom class, enter the custom class name, then click 'Add custom value'.

The value is added to the menu.

enableMultiAuth set to 'Yes'

enableMultiAuth - If you select 'Yes', a new section displays with multiAuthWelcome and multiAuthselect' fields, and a section for each authentication method you choose to configure.

multiAuthWelcome - Enter welcome text to show on login selection page.

multiAuthSelect - Enter the text to show on login selection page.

authMethods 

Click +Add "authMethods".

A new section displays.

allowAnonymous - Can users access MediaSpace without logging in? If you select 'yes,' anonymousRole users can browse the galleries and view videos. For anonymousRole users, links/buttons for actions that require more advanced roles are displayed. When an anonymousRole user clicks a link/button that requires a more advanced role, a login screen is displayed.

anonymousGreeting - What text should be used in the header instead of an actual user name?

sessionLifetime - Set how long (in seconds) a MediaSpace user session can last. If set value is lower than the minimum of 3600 seconds (1h), the minimum wil be utilized.

refreshDetailsOnLogin - Select 'Yes' to update the user's details on Kaltura upon login (recommended).

refreshRoleOnLogin - Select 'Yes' to update the user's role on Kaltura upon login. Select 'No' to allow KMS admin to override the user's role through Kaltura user management.

ldapServer

Click Expand to display the LDAP server options.

ldapOptions

Click Expand to display the LDAP Options for group searches.

ldapGroups

Click Expand to map your LDAP server groups to MediaSpace roles. The group value should be the value of the CN part - i.e. 'faculty', not 'CN=faculty'

SSO

Click Expand to configure the video portal login through SSO gateway.

headerAuth

Click Expand to configure KMS login through Header Authentication.

forgotPassword

Click Expand to define the values for the Forgot Password options.

adminsGroup - Enter a group ID to which any KMC or EP users will be added upon login to the site.

Click Save.

About

This module is used to set the root category for the application and to define which external applications or categories should be displayed to the user. 

Categories define the taxonomy and hierarchical structure of your MediaSpace site. You can access categories through the Navigation icon and browse your content according to the categories in which they are contained. Each category opens up the list of sub-categories that are pre-configured by your account administrator.

Configure

You must first set up the categories (and subcategories) in the KMC.

To set up a MediaSpace category tree in the KMC, create a MediaSpace root category.

1. Select the Content tab and then select the Categories tab.
2. Click Add Category.
3. On the New Category window, select the position of the root category and save your new category. See Managing Categories for more information.

rootCategory - Select the Root category from the available categories. 

showExternalPublish -  Set to Yes to show entry categories from external applications.

Add Content from External Applications

Click +AddexternalApplications to add external applications. You may configure multiple external applications

externalApplications -  Set the fields in this section for each external application you want to add. 

When you have an additional LMS extension or additional MediaSpace instances you may display where this media published in other applications that are connected to this MediaSpace. For more information, see Applications Interoperability - External Applications Feature.

applicationName - Select the display name for this application. Users will see this name in My media.

applicationRootCategory - Select the external application name.

Select the Category from the drop down list.

type - select either MediaSpace KAF application or other.

Restrict Categories to Certain Users

restricted - Restrict categories to specific roles. Only users with the specified role can view media in the restricted category. 

+Add "restricted" - Click to configure the restrictions. You may set restrictions on multiple categories.

category -  Select a category from the drop down menu.

roles - Select one or more roles that can access the restricted category. Use 'Ctrl' to select multiple roles.

Configure Who Can View Categories

By default, categories may be accessed by all authorized users.

allowAnonymous - When allowAnonymous mode is enabled, open categories may also be viewed by anonymous users.

To enable Anonymous mode

1. On the Configuration Management panel of the Kaltura MediaSpace Administration Area, open the Auth tab.
2. Under allowAnonymous, select Yes and click Save.

Related Modules

• Auth Module
• Gallery Module

About

The Channels module is used to set up channels, configure roles and permissions for creating channels, and set the channel page display, sorting settings, and other configurations. To learn more about video portal channels, check out our article Understanding channels.

Configure

1. Go to your Configuration Management console and click on the Channels module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/channels.

The Channels page displays.

2. Configure the following:

entriesPageSize - Enter the number of entries to display on each channel page (the default is 15).

pageSize - Enter how many channels to display on the channel page (the default is 20).

The settings below apply for the channel types and user permissions, see Kaltura MediaSpace Channels and Permissions Planning Guide for more information.

defaultChannelType - Select the default channel type when creating a new channel: 

• Open
• Restricted
• Private
• Shared repository
• Public
• PublicOpen

channelCreatorOpen - Select the minimal role that can create Open Channels:

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

channelCreatorRestricted  - Select the minimal role that can create Restricted Channels: 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

channelCreatorPrivate - Select the minimal role that can create Private Channels: 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

channelCreatorSharedRepository -  Select the minimal role that can create Shared Repositories: 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

channelCreatorPublic - Select the minimal role that can create "Public, Restricted" Channels: 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

channelCreatorPublicOpen - Select the minimal role that can create "Public, Open" Channels: 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

channelsTermUse -  Enter the 'Terms of Use' text that describes a general agreement or policy that is displayed to users every time a channel is created. The text is displayed at the top of the 'Create a New Channel' screen. 

supportPublicChannel - Set to 'Yes' to support the creation of channels that anonymous users will have access to. Contribution is allowed for logged-in users only according to their publishing entitlements. If set to 'No', anonymous users won't be able to view your public channels, and the option to create public channels will be removed from the 'Create a New Channel' page. 

channelsSorting - Use the drop-down menu to select the channels’ sorting default: Creation Date, Alphabetically A to Z, Alphabetically Z to A, Members, and Subscribers, Media Count, Update Date.

channelDefaultView - Select the default view for the channel page: Grid, Collapsed View,  Detailed View, or Table.

allChannelsPageDisplay - Select the minimal role that can view the All Channels Page:

• Anonymous role
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

myChannelsPageDisplay -  Select the minimal role that can view the My Channels Page:

• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

3. Click Save.

About

The Client module is used to manage and configure the connection between your video portal (KMS) site and the Kaltura server. It ensures that your video portal is properly linked to the server for streaming, analytics, and player functionality.

Configure

1. Go to your Configuration Management console and click on the Client module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/client.



The Client page displays.



2. Configure the following:

serviceUrl - The URL used for API calls. This is where your KMS connects to the Kaltura server. If you're using a self-hosted (On-Prem) Kaltura server, update this field accordingly. The URL's prefix must be http:// or https://.

CDNUrl - The URL used by the Kaltura HTML5 player and html5lib to access media through the CDN.

• Default URL: http://cdnapi.kaltura.com is used by default. If you don't need a custom URL, you can leave this field empty.
• Custom CDN: If you're using a custom CDN for media delivery, enter the custom URL in this field.
• For HTTPS Configurations: When your KMS site is set up with HTTPS, update this field to the secure CDN URL: https://cdnapisec.kaltura.com.

SecuredCDNUrl - The secure CDN URL used by the Kaltura HTML5 player and html5lib to access media over HTTPS.

• Default URL: Leave this field empty to use Kaltura’s default secure CDN.
• For HTTPS Configurations: When your KMS site is configured for HTTPS, update this field to the secure CDN URL: https://cdnapisec.kaltura.com.

analyticsServiceUrl - The URL for analytics and reports. Leave it empty unless you have a custom setup for reporting.

partnerId - Enter your Kaltura account's Partner ID. You can find it in the KMC under Settings > Integration tab.

verifySSL - Set this to "No" if you're using a self-signed SSL certificate. This allows the connection to bypass strict SSL verification.

3. Click Save.

About

The Debug module is a tool used to manage and configure logging for your video portal (KMS) site. It helps identify and resolve bugs or defects by recording event logs and messages, ensuring proper system operation and preventing incorrect behavior in areas like streaming, analytics, or player functionality.

The Debug feature also supports recording logs and debug messages on remote devices, such as the Kaltura SaaS server or an On-Premises server. These logs capture detailed information for troubleshooting.

Configure

1. Go to your Configuration Management console and click on the Debug module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/debug.



The Debug page displays.



2. Configure the following:

logLevel - The logLevel setting controls the severity and detail level of messages recorded in the KAF log file (logs/kms.log). This allows you to focus on specific types of events based on their importance or impact. Choose from the following levels:

Log level keyword	Level	Description
ALERT	1	System unstable
CRIT	2	Critical conditions
ERR	3	Error conditions
WARN	4	Warning conditions
NOTICE	5	Notification conditions
INFO	6	Informational messages only
DEBUG	7	Debugging messages
DUMP	8	Core dumps

kalturaDebug - Enables detailed logging of requests to the Kaltura API (logs/apidebug.log)

kalturaStats - Tracks and logs statistics of API requests (logs/api.log)

consoleLog - Configures whether logs are displayed in the console.

enableTemporaryDump - Temporarily sets the log level to DUMP for 30 minutes, enabling in-depth debugging. Click the button to enable DUMP log level for 30 minutes.



3. Click Save.

About

The EmailService module lets you send emails to video portal users using the email service you choose to configure in the module. You can configure how user-triggered emails (like registration) are sent, and then set up email templates for each trigger/action using the EmailTemplates module.

• Select Local to send emails via the Kaltura service using a few predefined kaltura.com addresses.
• Choose SMTP to set up your own SMTP email service.
• To use SES (Amazon’s Simple Email Service), please contact your Kaltura representative.

Configure

1. Go to your Configuration Management console, and click the EmailService module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/emailService.

The module page displays.

2. Configure the desired fields as follows:

There are three types of email services: Local, SMPT or SES. If you wish to use the SES (Amazon’s Simple Email Service), please reach out to your Kaltura representative.

Local

Local uses the Kaltura service and sends emails from donotreply@kaltura.com. It doesn't give you any permission to modify or customize who the sender is.

1. Service - Select 'Local' from the dropdown.
2. emailFrom - Enter the email sender.
3. nameFrom - Enter the sender's name to display on emails sent via the email service. If left blank, the site’s title will be used instead.
4. Click Save

SMPT

Simple Mail Transfer Protocol (SMTP) is a TCP/IP protocol used in sending and receiving email. It is typically used with POP3 or Internet Message Access Protocol to save messages in a server mailbox and download them periodically from the server for the user. This allows you to send emails from a gmail account or whatever service provider you choose.

For SMTP, complete the following fields:

1. Service - Select 'SMTP' from the dropdown.
2. host - Enter the SMTP host name. 
3. securedProtocol - Select from the dropdown the secured or encryption protocol that you want.

   

   SSL (Secure Sockets Layer) is the standard technology for keeping an internet connection secure and safeguarding any sensitive data that is being sent between two systems. TLS (Transport Layer Security) is an updated, more secure, version of SSL.

4. port - Enter the port used to connect to the SMTP host.

   Port 587 is the default port for SMTP submission on the modern web. While you can use other ports for submission, you should always start with port 587 as the default and only use a different port if circumstances dictate (like your host blocking port 587 for some reason). Port 587 also supports TLS, which means that you can securely submit mail.

5. authentication - Does your SMTP server require an authentication? If it does, select 'Yes'. If not, select 'No'. If you select 'Yes', the screen expands and you are asked to complete the following fields:

• username - used to authenticate
• password - used to authenticate

SES

Amazon SES is a cloud email service provider that can integrate into any application for sending bulk email and lets you reach customers without an on-premises Simple Mail Transfer Protocol (SMTP) system. If you wish to use the SES (Amazon’s Simple Email Service), please reach out to your Kaltura representative.

About

Use this module to set up email templates that will be sent out to users. 

Ensure there are no Access Control Profiles set up for specific domains. The video portal uses four types of email templates for registration:

• registrationEmailTemplates (verification mail)
• confirmationEmailTemplates (confirmation mail)
• passwordEmailTemplates (reset password mail)
• passwordConfirmEmailTemplates (password updated successfully)

All emails support the following tokens: {FIRSTNAME} {LASTNAME} {COMPANY} {COUNTRY} {EMAIL} {URL} {QRCODE}. You can add a template for each language by clicking +addRegistrationTemplate.

Configure

1. Go to your Configuration Management console, and click the EmailTemplates module. You can also navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/emailtemplates.

The EmailTemplates module page displays.

2. Configure the following:

+Add "template" - Click to add a template per local code. Configuring this section adds localized versions of a specific email template. 

templateName - Enter a template name that will be used to identify the template, for example: Confirm registration and set password.

localizedTemplate - Templates for a specific locales. When no locale fits - the template for En (English) is used. 

languageCode - Select the language of the email from the drop-down menu. The default is English (En), and is used when no other selection fits. 

subject - Type in the email subject line, for example, Confirm registration and set password.

body - Type in the email body in html. This field supports custom tokens from the language module, and also the following local tokens: {FIRSTNAME} {LASTNAME} {TITLE} {COMPANY} {COUNTRY} {EMAIL} {URL} {QRCODE}

bodyAsText - This is for calendar invites only. The body of the invite, displayed in the email, supports HTML formatting. However, the bodyAsText field should be plain text without any HTML, as it appears in the calendar invite itself. Tokens can still be used, as shown in the example below:

The siteRegistration module is further configured to support this type of invitation.

If you are using the emailLogin module, you can use {MAGICLINK} as an authentication link to the site and {MAGICLINK}&ref=[relative path] to link to a specific URL.

3. Click Save.

HTML examples used in the body of the email

Confirm registration and set password

Hi {FIRSTNAME} {LASTNAME} <br><br>

Click on the <a href={URL}> following link</a> to confirm your account registration and to set your password. <br> 

{URL}<br><br>

Thank you!

Registration complete

Hi {FIRSTNAME} {LASTNAME} <br><br>

Thank you for registering for the KMS. <br>

Please log into the <a href="{URL}"> KMS </a> <br><br>

Thanks!

Reset your password  

Please <a href="{URL}"> click here </a> to reset your password <br><br>

Please note:  This link will expire after 30 minutes. <br><br>

Reset password confirmation

Hi {FIRSTNAME} {LASTNAME} <br><br>

Your password has been reset <br>

Please login to the <a href="{URL}"> KMS </a><br>

Thanks!

About

The Gallery module enables the setup and management of galleries, which establish the taxonomy and hierarchical structure of your video portal (KMS). Administrators create galleries through the KMC, and they can be accessed via the video portal’s navigation header. This module provides flexible configuration options for organizing and displaying content.

Check out our user guide Create a gallery for more information.

Configure

1. Go to your Configuration Management console, and click the Gallery module. Or navigate directly using a link: https://{your_KMS_URL}/admin/config/tab/gallery.

The Gallery page displays.

2. Configure the following:

pageSize - How many entries should be loaded onto the display for the initial gallery page. (The default is 16, max is 150). You may scroll down to view all of the entries.

pageSizeWide - How many entries can be displayed on each gallery page in the Wide gallery view, e.g., search results, playlists (the default is 24).

defaultGalleryType - Select the default gallery type when creating a new gallery (the default is private): 

• Open
• Restricted
• Private

galleryCreatorOpen - Select the minimal role that can create open galleries (the default is viewer role):

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

galleryCreatorRestricted  - Select the minimal role that can create restricted galleries (the default is viewer role): 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

galleryCreatorPrivate - Select the minimal role that can create private galleries (the default is viewer role): 

• No role - System admin only
• Viewer role 
• Private only role
• Admin role
• Unmoderated admin role
• Specific users / groups

sortMediaBy - Set the default media sort for all categories: Channels, Galleries in KMS, and Media Galleries in KAF Applications. Choose from the drop-down list:

• Creation date
• Update date
• Alphabetical
• Views
• Plays
• Likes
• Comments
• Webcast start / end date

globalSearchSortMediaBy - Select the default sorting method for media results in the global search. Choose from the drop-down list:

• views 
• recent
• alphabetical
• likes

thumbnailRotator - Enable thumbnail image rotation on mouseover in galleries.

categoryDefaultView - Default view for categories. Select from Grid, Collapsed View or Detailed View.

The example below shows Detailed view.

playlistDefaultView - Choose the default view for playlist page (gallery-like page) that is linked from the homepage. Select from Grid, Collapsed View or Detailed View.

The example below shows Collapsed view.

firstTabLoad - Select the tab you want to load first in categories: media, categorymoderation or channelcategories.

In the example below, the channelcategories has been selected and displays as a Channels tab.

tableView - Set to 'Yes' to add the table view to all Channels. When enabled, this will be the default view on any channel for all users.

disableCategoryFullNameInURL - Set to 'Yes' to display only the category name, without its parent categories hierarchy in the URL. By default, the full category name is used, including the full hierarchy.

In the example below, the setting is 'Yes'.

In the example below, the setting is 'No'.

3. Click Save.

This module is used to configure settings for the header.

Configure

1. Go to your Configuration Management page and click the Header module. You can also navigate directly using a link: https://{your_site_url}/admin/config/tab/header 

The Header page displays.

2. Configure the following:

headerStyle - Choose from light or dark to correspond with the background and theme for your video portal header.

logoImageUrl - Specify a URL for an image to use as the site's header logo.

logoImageUpload - Upload an image to use as the site's header logo.

logoAltText - 'logoAltText' serves two purposes:

1. Accessibility: Conveys the "why" of the image to screen readers.
2. Functional: In case the image in 'logoImageUrl' or 'logoImageUpload' is unavailable, the text will be displayed.

logoLink - Options for defining logo click behavior:

• Enter 'false' for a non-clickable logo.
• Enter 'home' to display the homepage when the video portal opens.
• Enter a full URL (starting with http://) to open a different page in a new browser window/tab.

enableUploadButton - Choose one of the options from the drop-down menu:

Enable - Shows the Add New button in the site's header (for instances with the basic UI) / enables the +Create button (for instances which have Theming enabled). 

Disable - Hides the Add New button / disable the +Create button.

Logged-in Only - Hides the Add New button in the site's header (for instances with the basic UI) / disables the +Create button (for instances which have Theming enabled) if a user isn't logged in.

stickyNavbar  - Set to 'Yes' to enable the navigation bar to remain visible when users scroll down.

3. Click Save.

User experience

The example below shows a Video Portal homepage with the sticky navbar enabled:

The example below shows a Video Portal homepage with the sticky navbar disabled:

Related Modules

• Theming
• Headermenu

About

The Languages module in Kaltura's Video Portal and KAF applications provides powerful tools for customizing and localizing text across the platform. It enables administrators to adapt the user interface for regional specificity, support multi-language events, and make modifications to preconfigured text as needed.

Using the Languages module, KMS and KAF admins can:

• Replace text anywhere in the environment to reflect local preferences or meet client requirements.
• Configure localization for multi-language events, ensuring a seamless user experience for diverse audiences.
• Modify system-generated text to align with specific branding or terminology.

The module is case-sensitive.

Watch the video tutorial for information on customizing languages and text in the video portal.

Prerequisite

In the Application module, set the following:

• languageConfiguration – Set the instance configuration: multi-language instance or single language instance.
• languageSelection - When the instance is configured to multi-language, select the languages available.
• language - Choose the default language for a new user in this specific instance.

Configure

1. Go to your Configuration Management console and click on the Languages module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/languages.

The Languages page displays.

2. Configure the following:

DownloadLocaleText

Click Download Texts to download a zip file containing all the latest UI text strings for all languages used in this instance. These text resources represent the words and phrases displayed on the site's user interface (UI) and can be used to create or update custom languages.

Example of PO file in English

Select the desired language and modify the text as necessary. You can use translation editors available on the web,  for example, poedit, to modify text. The final result should be a binary .mo file.

UploadCustomLanguage

If a required language is not available, you can add it here.

Click +Add "UploadCustomLanguage".

Additional fields display.

languageAdminName - Insert the name of the language to be presented in the language drop-down list for admin, in the Application module's 'languageSelection' and 'language' fields.

languageClientName - Insert the name of the language to be presented in the language drop-down list for the users.

languageCode - for KAF only - Select the formal language code for syncing the instance language with the hosting application (LMS, CMS, SBS).

localeFile - Upload your customize .MO file.

localeIcon - Click Upload Flag to upload a custom language flag icon to display in the KMS drop-down list when the language is selected. The icon should be in one of the following formats: *.jpg, *.jpeg, *.bmp, *.png, *.gif, *.tif, *.tiff, *.ico, and sized to 30px x 26px for best visual results (images will be resized automatically if needed).

languageId - Unique language id for application usage (not for KMS/KAF admin usage).

LanguageException

Use this section to customize site text for translations in multi-language events or to modify existing terminology. Download the English PO file to retrieve all relevant text in the form of msgid.

Click +Add LanguageException.

Additional fields display.

Language - Select the language you want to apply the exception to.

msgid - This is the text you would like to change. You should copy the EXACT msgid text from the PO file.

Exception - Enter the new text (the translation) to replace the existing one. 

Click Save.

Below is an example:

importAndExportExceptions

You can manage language exceptions for your site. 

Click Expand.

Click Export Exceptions to download a file of all exceptions you have configured.

The file format is CSV, without a header line, and contains three columns: the selected language, the msgid, and the Exception. An example is shown below:

Import - You can upload a list of all language exceptions. Click Choose file and upload the CSV document from your computer.

CustomToken

Custom tokens provide a simple way to replace variables in KMS text. They are especially useful for creating and personalizing email templates or other text sent to users, such as disclaimers.

You can insert custom tokens into the body of an email template or other text fields, and the system will automatically populate their values. Additionally, you can set a language for each custom token, ensuring that when the KMS instance language is changed, the token value updates automatically to match the selected language.

Click +Add "CustomToken".

An additional field displays.

TokenID - Enter an alphanumeric ID. This will be used as {Your_Token_ID} in other modules.

LocalizedToken - Use this to translate the token into multiple languages, if needed. If no translation is needed for the token - use only one localized token.

Click + Add "LocalizedToken".

Additional fields display.

Language - Specify the language code for the token.

TokenValue - Enter the replacement text for the token. This is the value that is displayed wherever the custom token is used. 

Example

In the following screen, SITETITLE is used as the TokenID.

The custom token (enclosed in curly brackets) is applied in the Disclaimer text.

The TokenValue, in this case, "my super site," replaces every instance of the TokenID. You can substitute different TokenValues as needed without modifying the Disclaimer text or Email Templates directly.

Custom tokens can be configured for all available languages. For example, you can select a language and input a TokenValue (for example, "Los Videos").

When you change the language of your instance, the custom token automatically updates with the corresponding TokenValue, eliminating the need to manually adjust the Disclaimer or Email Template text.

3. When you have finished configuring the module, click Done.

About

Related modules

• Theming
• Auth

Configuration fields

Page header 

The following fields define the header display for the login page:

headerText  -  Enter text that is displayed at the top of the page, next to the logo. 

headerBannerDefaultImg -  Use to upload an image to display as the background of the login page's header. Since the image will be cut according to page size, is it recommended to upload an atmospheric image the size of around 1600x400 pixels. Leave empty to use the default blue.   

showLanguageSelector  Use to present the language selector (assuming it is available on the site), set to 'Yes'.

customLogo - use to set a different logo on this page from the site's logo.

Page texts

Title - Use to change the main title of the login page. leave empty to use default

• Login instructions and field placeholders can be added/set from the Auth module, using the phLoginInstruction, phUser, and phPwd fields. 

Multi Authentication

The multi authentication page will automatically be updated to the new UI. The settings will remain the same and may be re-configured from the Auth module)

Call to Action feature

You may add a call to action on the login page using the showCallToAction fields. Set the showCallToAction field to Yes, to open the CallToAction section.

Fill in the configuration as you please to show a call to action button on the login page:

About

Follow these steps to configure your Media Collaboration settings, enabling collaboration features, managing media ownership, and customizing user options.

Check out our Add / remove collaborators user guide.

Configure

1. Go to your Configuration Management console, and click the MediaCollaboration module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/mediaCollaboration.

The MediaCollaboration page displays. 

2. Configure the following:

mediaCollaborationEnabled - Set to 'Yes". Enabling this feature also allows the media owner to be changed, and co-editors, co-publishers, co-viewers and Webcasting moderators to be edited. 

changeOwnerEnabled - (This field is only available when the MediaCollaboration module is enabled.) The 'change media owner' feature (as shown below)  provides the ability to change the owner of the media. 

collaborationEnabledInUploadForm - Enable the option to add collaborators (co-editors, co-publishers, co-viewers, Webcasting moderators) in the upload media form. 

showInSearch - Set to 'Yes' to enable filtering by ownership and collaboration.

excludeGroups - Enter the group or user IDs, separated by commas, to hide from the 'Add a Collaborator' and 'Change Media Owner' search (as shown below). This means that those users and groups will be excluded from the search options; all others can be found.

3. Click Save.

User experience

After enabling the module, a Collaboration tab displays on the Edit media page:

Users can Change Media Owner:

Users can Add a Collaborator:

About

The Metadata module ensures data consistency and improves content organization. It requires essential fields like descriptions and tags to be filled, ensuring comprehensive metadata for each piece of content. The "Read more" feature shortens lengthy descriptions for better display, preserving content integrity. Additionally, customized tooltips provide guidance for users during content creation or editing. 

For the user guide, see Media metadata.

Configure

1. Go to your Configuration Management console and click on the Metadata module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/metadata.

   

   The Metadata module displays.

   

2. Configure the following fields:
   descriptionRequired - Set to 'Yes' if you want to require users to fill in the Description field before media can be published or added to a playlist.
   tagsRequired - Set to 'Yes' if you want to require users to fill in the Tags field before media can be published or added to a playlist.
   readMoreEnabled - Set to 'Yes' to enable Read more for media, channel, and gallery descriptions, shortening them to 500 characters.

   This field does not pertain to the Theming feature set.

   The image below illustrates how the "Read more" feature appears when enabled.
   basicNameFieldHelperText - Enter text for a tooltip for the Name field when uploading or editing an entry.
   basicDescriptionFieldHelperText - Enter text for a tooltip for the Description field when uploading or editing an entry.
   basicTagsFieldHelperText - Enter text for a tooltip for the Tags field when uploading or editing an entry.
   showDescriptionInTooltipMeta - Set to 'Yes' to display the field's description as a tooltip.
3. Click Save.

About

Users can click on the flag icon, and then choose a reason for reporting the content. The administrator can then review content before it's published to eliminate spam and inappropriate content.

Using the Moderation module administrators can change the reasons for moderation text. See Moderating Content to learn more about the KMC admin's experience.

Prerequisites 

The Moderation plugin must be available on the player for users to select it.
To learn how to set the Moderation Plugin on the player, see https://knowledge.kaltura.com/help/universal-studio-information-guide#moderation.

Setup

1. Go to the KMS admin page and navigate to the Moderation module.
2. Enter the reasons users can choose for flagging media. (If none are provided, the default Kaltura reasons will be used)
   • reasonSex
   • reasonViolence  
   • reasonHarmful
   • reasonSpam
3. Click Save.

Use this module to select which columns to display for the My Media table view.

The table view is displayed when selecting the Table View icon on your My Media Page. 

About

Site navigation is the way visitors move through your site's pages and content. The navigation bar generally displays the pages and sections on your site that your visitors can click on and be redirected to..

Navigation style

1. Go to your Configuration Management console, and navigate to the Navigation module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/navigation.

   

   The module page displays.

   

2. Configure the following:

showNavigation - Choose if navigation should be displayed (the default is 'Yes').

The image below displays showNavigation set to 'No'.

The image below displays showNavigation set to 'Yes'.

navigationStyle - Choose whether you want a horizontal or vertical header. Vertical displays a hidden menu on the left side for all screen sizes, while horizontal shows a top menu on desktops and switches to vertical on smaller screens.

The image below shows the navigation style set to vertical.

showNavbarSearch - Choose if the search box in the header should be displayed (as shown in the image below). The default is 'Yes'.

includeCategories - Select 'No' if you don't want the categories to display in the main navigation and only want PRE and POST items to appear

Landing page

Set a special landing page for guests either by creating a custom page in the templatepages module or using an existing page like Global search. Add your page to the custompages module, then link it to the site navigation using the landingPage field (as shown below). Ensure the page is accessible to guests by setting it to Guest override or using a public channel page. 

• enabled - Set to 'Yes' to enable the landing page.

• type - Select the type of page to use from the drop-down menu:
• Playlist - Enter a playlist ID. This will redirect users to that playlist's page.
• Link - Enter any link to redirect users to (for static pages).
• Category - Choose a gallery from a drop-down list. This will redirect users to that gallery.
• Entry ID - Enter an entry ID. Will redirect users to that entry's media page.
• Channels page - This will redirect users to the Channels page (https://{Your mediaspace}.kaltura.com/channels).
• Channel - Choose a channel from the drop-down list. This will redirect users to that channel's main page.
• Custom page - Choose a custom page from the drop-down menu (added from the custompages module). This will redirect guests to the template page.

Page types other than 'link' must be in a video portal that has been set to allow anonymous users.

Depending on what you choose from the type drop-down list, other options will display as follows:

• value - Enter the relevant value for the selected type: URL for links, ID for Playlist. To add the homepage you created above, simply enter a slash (/) in the field instead of the entire slug.
• category - Click the blue Select Gallery button and enter the gallery name or ID.
• entryID - Enter an entry ID to redirect users to that entry's media page.
• channel - Click the blue Select Channel button and enter the channel name or ID.
• page - Select a custom page from the drop-down list (as shown in the example below). A custom page in status 'disabled' won't be shown on the menu.

Homepages

Here you can add one or multiple pages to your site's base URL for logged-in users. You can design a new page in the templatepages module, or use a page such as the Global search as your homepage. Just add your page to the custompages module, then link it to the site navigation here.

Click +Add "homePages".

In the section that displays, configure the following:

• enabled - Set to 'Yes' to enable the landing page.
• type - Select the type of page to use from the drop-down menu:
  • Playlist - Enter a playlist ID. This will redirect users to that playlist's page.
  • Link - Enter any link to redirect users to (for static pages).
  • Category - Choose a gallery from a drop-down list. This will redirect users to that gallery.
  • Entry ID - Enter an entry ID. Will redirect users to that entry's media page.
  • Channels page - This will redirect users to the Channels page (https://{Your mediaspace}.kaltura.com/channels).
  • Channel - Choose a channel from the drop-down list. This will redirect users to that channel's main page.
  • My Media - This will redirect users to the My Media Page, and will only show for permitted roles.
  • My Playlists - This will redirect users to the My Playlists page.
  • My Channels - This will redirect users to the My Channels page.
  • My content analytics - This will redirect users to the My content analytics page.
  • Custom page - Choose a custom page from the drop-down menu (added from the Custompages module). This will redirect users to the custom page, and will only show if the page is enabled. 
• value - Enter the relevant value for the selected type: URL for links, ID for playlist.
• allowedGroups - You can choose a group to display this homepage to. Leave it empty to show it to all users or users not in any homepage group. For users in multiple groups, the first homepage will appear. If no groups or alternative homepages exist, the first item from the Pre/Post navigation list they have access to will be shown.



• Click +Add "allowedGroups".
• In the new section that displays, click Select Groups.
• Type in a group name or ID.
• Click Submit.

Repeat these steps to add more groups.

'Pre' menu

Next is the Pre section. This is where you'll add menu items to the beginning of the navigation bar (before the galleries or 'categories'). Your video portal displays the items in the order you define here.

Configure the following:

name - Enter the label for the menu item. The label is displayed in the main navigation bar.

type - Select one of the options:

• Playlist - Enter a playlist ID. This will redirect users to that playlist's page.
• My Media - This will redirect users to the My Media page, and will only show for permitted roles.
• My Playlists - This will redirect users to the My Playlists page.
• Link - Enter any link to redirect users to. 
• Category - Choose a gallery from a drop-down list. This will redirect users to the gallery page.
• Entry ID - Enter an entry ID. Will redirect users to that entry's media page.
• Channels page - This will redirect users to the All Channels page.
• My Channels - This will redirect users to the My Channels page.
• Channel - Choose a channel from the drop-down list. This will redirect users to that channel's main page.
• Label - Only input text for a label. You can use this to organize content beneath the label in a hierarchy.
• Partner KMS URL - Enter a link to another Video Portal in the same partner. This enables logged-in users to access that Video Portal without needing to log in again.
• My Content Analytics - This will redirect users to the My Content analytics page.
• Custom page - Choose a custom page from the drop-down menu (added from the Custompages module). This will redirect users to the custom page, and will only show if the page is enabled.

Depending on what you choose from the type drop-down list, other options will display:

• value - Enter the relevant value for the selected type: URL for links, ID for Playlist. To add the homepage you created above, simply enter a slash (/) in the field instead of the entire slug.
• sameWindow - The default is 'No'. Select 'Yes' if you want the page to open in the same window.
• category - Click the blue Select Gallery button and enter the gallery name or ID.
• entryID - Enter an entry ID to redirect users to that entry's media page.
• channel - Click the blue Select Channel button and enter the channel name or ID.
• url - Enter the base URL of another video portal in the same partner. This enables logged-in users to access that video portal without needing to log in again.
• page - Select a custom page from the drop-down list. (A custom page in status 'disabled' won't be shown on the menu.)

allowedGroups - Choose the group that should see this item. A user who's not in that group won't see this page in their navigation menu.

If you choose a type which has a drop-down menu, you can add items to the dropdown by clicking +Add items.

The items section expands. Configure the following:

• name - Enter the name of the menu item. The name is displayed in the main navigation bar.
• type - Select one of the options from the drop-down list (see above). Depending on what you choose from the drop-down list, other options will display (see above).

To create the next 'pre' element, click +Add "pre" and repeat the steps.

Below is an example of 'Home' positioned as the first item in the navigation bar, using the homepage that was configured in the homepages section above.

'Post' menu

Next is the Post section. This is where you'll add items that come after the galleries (also known as 'categories'). Your Video Portal displays the items in the order you define here.

Click +Add "post".

Follow the steps in the Pre menu section above.

To create the next post element, click +Add "post" again and repeat the steps.

Below is an example of the Channels page as the main link, and the 'Survival skills' channel as the first item in the drop-down menu.

Finally, when you have finished your configurations, scroll down and click Save.

About

This module is used to set the default main player in KMS and KAF applications. The height of the player UI may be configured as well as the ratio of the video inside of the player.

Configure

playerId - Enter the player ID (uiConf ID) for the instance’s main default player used in all media pages. This is also the fallback for many modules, in case no specific player is entered.

Set the Visual Display of the Player

Use the following fields to determine the player's display on your screen.

playerBarHeightPixels - Enter the height (in pixels) of the player UI that is not part of the actual video (for example - the bottom bar.)

playerVideoRatioPercent - The ratio (in percent) of the video inside the player. Standard values: 16:9 = 56.25 , 4:3 = 75 , 16:10 = 62.5.

Set a Player for Editing Purposes

playerEditId - You may choose to edit entries using a different player. Enter the Player ID for editing data. If left empty the default Player ID is used.

autoPlayOnLoad - When set to Yes, the video that is loaded in the player begins playing automatically.  Autoplay is triggered each time a new page loads.
Selecting Yes or No will override the player settings, whereas choosing UsePlayerSettings will retain the current player settings.

Set a Player for Moderated Content

playerModerationId - The Player ID for the player used in Channel and Gallery moderation ta. If left empty the default Player ID is used. For more information about moderation in KMS see Managing a Gallery in Kaltura MediaSpace or Managing a Channel in Kaltura MediaSpace.

Where Can you Set Player IDs for Different Types of Media?

Media Players are created and configured in the KMC Studio tab. You can apply the same player across the application or customize multiple players for different types of media/repositories/components. In the KMC, navigate to the Kaltura Player Studio tab to find the Players List. Please visit The Kaltura Player Studio Getting Started to learn more.

The following lists the types of media and where you may override the default player's id:

• Video - uses the playerId from the Player module.
• Quiz - uses the quizPlayerId or the BSEPlayerId from the Quiz module.
• Audio - uses the customPlayerId  from the Audioentry module.
• Playlists - uses the playerId from the PlaylistPage module.
• Image - uses the customPlayerId from the Imageentry module.
• Webcast/Live - uses the PlayerUiconfId from the Kwebcast module.
• Rapt Media - uses the playerId from the Raptmedia module.
• Youtube - uses the previewPlayer from the Youtube module.
• Twitter - uses the tPlayerId from the Twitter module.
• Facebook - uses the fPlayerId from the Facebook module.
• Oembed - uses the PlayerId from the Oembed module. For more information, see the article about MediaSpace oEmbed Integration.
• Embed - uses the uiConfId from the Embed module.
• Browseandembed - uses the BSEPlayerId from the Browseandembed module. 

Related Modules

• Quiz module
• Audioentry module
• PlaylistPage module
• Imageentry module
• Kwebcast module
• Raptmedia module
• Youtube module
• Twitter module
• Facebook module
• Oembed module  
• Embed module
• Browseandembed module
• Channeltheme module
• Entrydesign module
  
  

About

This module controls the visibility of playlists.

• To enable the Channel Playlist functionality, navigate to the Channelplaylists module.
• To enable the ability to add content to personal playlists, navigate to the Addtoplaylists module.
• To enable the ability for users to grab embed codes of playlists, navigate to the Embedplaylist module.

Check out our Playlists user guide.

Configure 

1. Go to your KMS or KAF admin page, and navigate to the PlaylistPage module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/playlistPage.
   The PlaylistPage window displays.
   playerID - The playerId field should already be populated. To change the playerId, see The Kaltura Player Getting Started Guide.
2. Thumblink - Choose how you'd like the thumbnail link to behave:
   • Redirect to Playlist Player - This will redirect the user to a dedicated playlist page with the player pointing to the selected media.
   • Redirect to Single Media page - This will take the user to the single media page, without the context of the playlist.

     Please note that this applies to manual playlists only. For dynamic playlists configured in the Templatepages module, such as "Most recent" or "Most viewed", (excluding "Custom playlist"), clicking on the thumbnail will exclusively direct you to the entry page and not the playlist page.

3. Click Save.

Example of playlist with Thumblink set to Redirect to Playlist player:

Example of playlist with Thumblink set to Redirect to single media page:

About

The Recaptcha module enhances security in Kaltura's Video Portal by integrating reCAPTCHA capabilities into login and registration email workflows. It helps prevent abuse, such as repetitive email-sending attacks, by using the reCAPTCHA service.

To configure this module, you'll need specific API values provided by your Kaltura representative. These values ensure seamless integration and optimal security for your video portal instance.

Configure

1. Go to your Configuration Management console and click on the Recaptcha module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/recaptcha .
2. The Recaptcha page displays.
3. Configure the following:

   • apiKey - Fill in API Key as provided by the reCAPTCHA provider. Kaltura domain default is: AIzaSyBnnWQH1fQdGIfMBcjKhK0vaXBAJVob96I

   • projectId - Fill in Project Id as provided by the reCAPTCHA provider. Kaltura domain default is: firestore-android-633cf

   • siteKey - Fill in Site Key as provided by the reCAPTCHA provider.

     • Kaltura domain default for visible reCAPTCHA is: 6LcIrW0dAAAAAI3lMqpYjPoBuoa3RiJLkXKUe-Sh
     • Kaltura domain default for hidden reCAPTCHA is: 6LdxTKMhAAAAAJHcLLlmKhOl_eitdyGwuMBaiPcg

   • theme - Choose to use the Dark or Light reCAPTCHA theme.

   • mode - Choose to use a visible or hidden reCAPTCHA in your site. Make sure to change the siteKey to a dedicated key per your selection.

4. Click Save.

About

The Search module unlocks your vast video library, offering convenient access through both the header bar and the dedicated global search page. Optimized for video content, it provides accurate and efficient search capabilities.

Key features

• Tailored for video: Understands video-specific metadata for relevant results. 
• Comprehensive search: Covers regular, custom, and temporal metadata.
• Complete access: Search your entire library, including private and niche content.
• Fine-grained control: eSearch API empowers advanced query construction.
• Elasticsearch integration: Delivers seamless and unified search results across all data fields.

Search options

• Instant header search: Quickly find specific videos using keywords on any page.
• Deep dive with global search: Explore the entire library, browse categories, and refine your search.

Specially for Theming users!

• Customized homepage: Transform the search page into your site's entry portal. Customize the title and description to reflect your site's identity or brand, and create a unique starting point for your users' adventures. 

These instructions will help you choose the right tools for your use case.

For Theming users, check out our Global search user guide.

Enable the module

1. Go to your KMS Configuration Management console, and navigate to the Search module. Your link should look like this: https://{your_KMS_URL}/admin/config/tab/search.

2. In the Search window, you can set up the non-Theming-based or Theming-based search function.

Configure non-theming-based search 

If you don't have the Theming feature set enabled, this section is for you.

1. Configure the eSearch section:

eSearch In this section, you can choose searchable data on your site by using the eSearch options (matches in the title and subject of media are always included). tags - Set to 'Yes' to have media tags returned in the search results. Owner -  Set to 'Yes' to have media owners returned in the search results. RefId -  Set to 'Yes' to have media reference IDs returned in the search results. captions - Set to 'Yes' to have captions returned in the search results. Please note that this feature can be enabled regardless of the captions module status. customMetadata - Navigate to the Customdata module to have media custom metadata returned in the search results. kwebcast - Navigate to the Kwebcast module to have kwebcast fields returned in the search results. mediaCollaboration - Navigate to the MediaCollaboration module to enable the ownership filter.  pageSize - Select how many search results to display per page. Remember, higher numbers may slow down page loading. We suggest a page size of 30 results for best performance. KeepHeaderSearchOpen - Set to 'Yes' to keep the global search bar constantly expanded in the web view. Accessible from the top right header menu, users can open the Global Search by clicking the magnifying glass icon. Note that the search bar will cover any header menu items. 'KeepHeaderSearchOpen' set to 'No' (you can see the ‘All Channels’ and ‘Go-To’ links displayed in the header menu) 'KeepHeaderSearchOpen' set to 'Yes' (the ‘All Channels’ and ‘Go-To’ links are hidden)  SearchContext - Choose how search suggestions are shared between KMS instances. Suggestions are shared between all KMS video portal instances.  Suggestions are private per KMS video portal instance.  Suggestions are shared between KMS video portal instances having the same search context below: An additional field will open named CustomSearchContext - Fill in the "CustomSearchContext" field with a privacy context. This allows search suggestions to be shared with apps having the same context. For example, if you have many video portal sites and want suggestions shared between two, type in a context like 'MediaSpace Travel' in the Search module's CustomSearchContext of those two. This links the sites, enabling shared suggestions. Your SearchContext selection determines the 'recent searches' suggestions that will display in the search box.

2. Configure the remaining settings as follows:

showMediaSearch - Choose to display or hide the on-page media search.

inVideoPageSize - Choose the number of results to show in the media entry page’s timeline tab ‘search in media’ feature (for example, 5).

instantSearch  - Choose whether search results on the global search page should appear instantly or only after pressing Enter. We recommend lowering the page size to allow faster results population. 

showinfo - Select 'Yes' to provide an information icon  next to the search field. 

infotext - This text will show as a tool tip when hovering over the information icon. If left empty, the following default text will be used: To search for an exact match, please use Quotation Marks. Example: "computer"

3. Click Save.

Configure theming-based search 

If you have the Theming feature set enabled on your site, this is the section for you. Just make sure to set the globalsearch configuration to 'Yes', found under the Features section of the Theming module.

allContentText - This section is specifically for using the search page as a landing page. Check it out below if you're interested!

Configure the remaining settings as follows:

GalleryResults - Choose to display or hide the gallery results on the global search page. 

ChannelResults - Choose to display or hide the channel results on the global search page. 

Filters

Choose which filters to display on the search filters. This will affect search in all locations.

MediaType - Provides the ability to filter content by type, such as video, image, audio, and more.

Webcasts - Provides the ability to filter live content by its scheduling time.

Captions - Provides the ability to filter content with or without captions.

Duration - Provides the ability to filter content by duration of the media.

CreationDate - Provides the ability to filter content by creation date of the media.

LastUpdateDate - Provides the ability to filter content by the last update date of the media.

Ownership - Configured from the mediaCollaboration module.

PublishStatus - Provides the ability to filter content by its publishing status. Available for the My Media page only.

Scheduling - Provides the ability to filter content by its scheduling status. Available for the My Media page only.

To control customized filters, please visit the customData module.

Below is an example of a Theming-based global search page:

Set up as homepage

allContentText - Enter the text you want to display at the top of the page (HTML markup is supported). 

Next, you'll need to set up the page in the Navigation module pre-menu. This ensures users land on it first when logging in.

Below is an example of a global search page that also serves as a homepage (Theming):

To activate the global search page, make sure to set the globalsearch configuration to 'Yes',  found under the Features section of the Theming module.

About

The Security module in Kaltura's Video Portal helps administrators implement advanced security measures to protect the platform. Key features include enforcing HTTPS connections, restricting playback to specific IPs, and configuring HTTP headers like Content-Security-Policy, Permissions-Policy, and Cross-Origin policies.

These tools ensure secure access, control resource loading, and protect against unauthorized sharing and other vulnerabilities.

Configure

1. Go to your Configuration Management console and click on the Security module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/security.



The Security page displays.



2. Configure the following:

allowLoadInIframe - Allow MediaSpace to be loaded in Iframe. The default is NO for XFS.

enabledHsts - Return HSTS header. The HSTS header (HTTP Strict Transport Security) is a widely recognized security practice (not proprietary to Kaltura) used to enhance web application security. In Kaltura's Video Portal, this header is automatically returned when the sslSettings are configured as All Site in the Auth admin tab.

When the HSTS header is applied, the browser enforces HTTPS for the application domain where the header is set. Any attempt to access the site over HTTP will be internally redirected by the browser to HTTPS, ensuring secure connections at all times.

securePlaybackWithIprestrict - When enabled, this feature restricts every Kaltura Session (read more here) to the IP address that originally requested the playback, providing an additional layer of protection against unauthorized sharing.

The user's IP address is embedded into the KS, ensuring that if someone copies the embed code (which includes the KS) and shares it with another user, playback will be denied unless the second user accesses the Kaltura API from the same IP address.

cspHeader - This configuration adds the Content-Security-Policy (CSP) HTTP header to all web pages, specifying which resources the user agent is allowed to load for each page. It is important to thoroughly test the site after implementing any CSP headers to ensure all functionality operates as expected.

permissionsPolicyHeader - This configuration adds the Permissions-Policy HTTP header to all web pages, explicitly specifying which functionalities are allowed or restricted on the website.

referrerPolicyHeader - This configuration adds the Referrer-Policy HTTP header to all web pages that controls how much referrer information should be included with requests. Choose from the following options:

• no-referrer
• no-referrer-when-downgrade
• origin
• origin-when-cross-origin
• same-origin
• strict-origin
• strict-origin-when-cross-origin
• unsafe-url

crossOriginEmbedderPolicyHeader - This configuration adds the Cross-Origin-Embedder-Policy HTTP header to all web pages and used to configure embedding cross-origin resources into the document policy.

Choose from the following options:

• none
• unsafe-none
• require-corp
• credentialless

crossOriginOpenerPolicyHeader - This configuration adds the Cross-Origin-Opener-Policy HTTP header to all web pages and allows you to ensure a top-level document does not share a browsing context group with cross-origin documents. 

Choose from the following options:

• none
• unsafe-none
• same-origin-allow-popups
• same-origin

crossOriginResourcePolicyHeader - This configuration adds the Cross-Origin-Resource-Policy HTTP header to all web pages instructing the browser to block no-cors cross-origin or cross-site requests to the specified resource.

Choose from the following options:

• none
• same-site
• cross-origin
• same-origin

About

The SharedRepositories module lets educational institutions and enterprises create a shared media library where anyone with access can publish content to other areas in the video portal and KAF. Members can browse and publish media from the shared repository to other channels or categories.

Configure

1. Go to your Configuration Management page, and navigate to the SharedRepositories module. Your link should look like this: https://{your_site_url}/admin/config/tab/SharedRepositories  

The SharedRepositories page displays.

2. Configure the following:

enabled - Set to 'Yes' to enable the module.

amountOfSharedRepositories - Enter the number of shared repositories to show in the user dropdown (as shown below) when adding media to a channel from shared repository.

termsOfUseLink - Enter a link to the Terms of Use page.

nestedFilters - Set to 'Yes' to enable nested filters. Configure them as nested categories under root > site category in KMC. To learn more, visit our article Create nested filters.

customDataProfileId - Choose a custom metadata schema for media in the shared repository. All custom data schemas are created in the KMC and can be viewed in KMC > settings > custom data in KMC.

requiredFields - Choose which custom metadata fields are required before publishing media to a shared repository. Use custom data system names from KMC > settings > custom data.

3. Click Save.

About

The TimeAndDate module allows administrators to customize how dates and times are displayed throughout the application. This includes adjusting default date formats for different languages and defining how time is represented.

With this module, admins can configure three date formats used in various locations in the application:

• Long: Full date, including the day of the week (e.g., Saturday, June 12, 2025).
• Short: Date without the day of the week (e.g., June 12, 2025).
• Long with no year: Full date without the year (e.g., Saturday, June 12).

Each format is used on different pages or locations within the application. For details, see the Setting the Date and Time Format Display article.

Admins can also define language-specific date formats, which is especially useful for languages like Japanese, where unique date characters are required. By default, the system uses preconfigured formats, but these can be customized using tokens.

Date format tokens

Admins can build custom date formats using the following tokens:

• YYYY: 4-digit year (e.g., 2019)
• YY: 2-digit year (e.g., 19)
• MMMM: Full-length month (e.g., June)
• MMM: Abbreviated month (e.g., Jun)
• MM: Zero-padded month (e.g., 06)
• M: Month (e.g., 6)
• dddd: Full day of the week (e.g., Sunday)
• DD: Zero-padded day of the month (e.g., 01)
• D: Day of the month (e.g., 1)
• Do: Day of the month with an ordinal (e.g., 1st)

Examples of common date formats

• YYYY-MM-DD: Displays as 2019-06-01
• MMMM Do, YYYY: Displays as June 1st, 2019
• [The] Do [of] MMMM: Displays as The 1st of June
• M/D/YYYY: Displays as 6/1/2019
• YYYY[年] MM[月] DD[日] dddd: Displays as 2020年 5月11日 火曜日

Configure

1. Go to your Configuration Management console and click on the TimeAndDate module. You can also navigate to it directly using a link: https://{your_KMS_URL}/admin/config/tab/timeAndDate.



The TimeAndDate page displays.



2. Configure the following:

timeDisplay - Choose how to show the time in the application. Choose from AM/PM or 24h.

languageDates

Change the default date formats for any of the site’s languages.

Click +Add "languageDates".



Additional fields display.



language - Choose the language from the drop-down list you would like to apply these specific date format to from the site’s languages. Each language may have its own setting, if left empty, the default is used.

longDate - Full date including the day of the week, for example, Saturday, June 12, 2025.

shortDate - Date not including the day of the week, for example, June 12, 2025.

longDateNoYear - Date including the day of the week, but no year, for example, Saturday, June 12.

weekStartDay - Choose from the drop-down list which day starts the week.

uploadDateStyle - Select how the media upload date is displayed to users:

• Choose x time ago to display relative dates, such as "3 months ago" or "4 days ago."
• Choose On date to display absolute dates, such as "On 4/5/2019," based on the selected date format.

editTimeDisplay - Choose the display format for date selectors when editing media data of type "date only":

• Month-Day (American)
• Day-Month (European)

3. Click Save.

About

Using the Widgets module, you can set the Join Now button to appear on session cards a specified number of minutes before each session starts, helping users know exactly when to join. You can also control the visibility of media thumbnails on these session cards, which appear across Theming-based pages like the Channel page, Profile page, and Agenda page.

Configure

1. Go to your Configuration Management console and click the Widgets module. You can also navigate directly using a link: https://{your_video portal_URL}/admin/config/tab/widgets.



The Widgets page displays.



2. Configure the following:

ThumbnailOnSessionCard - Choose whether you want the thumbnail on the session card to be visible or hidden.

SessionCardJoinNowIndication - Enter the number of minutes before the session start time for the Join Now button to appear. Leave blank to use the default of 15 minutes. For example, if a session starts at 10:45 am and the indication is set for 15 minutes, the Join Now button will appear at 10:30 am, prompting users to join.

3. Click Save.

User experience

The image below displays a My Profile page with session cards where media thumbnails are set to visible:

For more information about session cards, visit our article Session cards.