Skip to main content

Search

Ravnur Knowledge Base

Embedding videos, audio, and playlists

Bruce Hudson
  • Updated

Embedding lets you display videos, audio files, and playlists on external websites using an iframe embed code. Embedding in RMP is controlled at three levels: a global application setting, a domain whitelist, and an individual item setting. All three must be configured correctly for an embed to work.

If you see "Embedding not permitted for this domain", the external site's domain has not been added to the domain whitelist. Contact your administrator to have it added before the embedded player will load.

 

1   How embedding works

For an embedded player to load successfully on an external page, three conditions must all be met:

🌐
Global setting — application-wide Embedding must be enabled for the application, or explicitly overridden at the item level. Contact Ravnur support to change this setting.
↓
🔒
Domain whitelist — destination site The domain of the external site must be added to the whitelist in Settings > Domain whitelist.
↓
🎬
Item setting — individual video, audio, or playlist Embedding must be enabled on the specific media item being embedded.

If any one of these three conditions is not met, the player will not load on the external page.

 

2   Global embedding setting

The global setting controls the default embedding behaviour for all new media uploaded to the application. It is managed by Ravnur and can be set to one of two states:

State Effect on new uploads Effect on existing items
Enabled (default on) All newly uploaded items have embedding enabled by default. No change to existing items.
Disabled (default off) All newly uploaded items have embedding disabled by default. No change to existing items.
Note: Changing the global setting only affects items uploaded after the change. It does not retroactively update the embedding setting on existing media items.
To change the global setting, contact Ravnur support. Even when the global default is disabled, embedding can still be enabled on individual items — see Item-level embedding setting below.

 

3   Domain whitelist

The domain whitelist defines which external sites are permitted to embed your media. Any domain not on the list will be blocked — visitors to that site will see the "Embedding not permitted for this domain" message instead of the player.

The whitelist is managed by administrators at Settings > Domain whitelist. Add the full domain of each external site where you plan to embed content (for example, www.example.com).

Note: A domain must be on the whitelist even if embedding is enabled globally and at the item level. All three conditions must be met for an embed to load.

 

4   Item-level embedding setting

Each video, audio file, and playlist has its own embedding setting on its General tab. This setting controls whether that specific item can be embedded, regardless of the global default.

To enable or disable embedding for an item:

  1. Open the item's detail page in the Admin portal.
  2. Go to the General tab.
  3. Toggle Allow embedding on whitelisted domains on or off.
  4. Save your changes.
Global default is disabled? You can still enable embedding for individual items using this setting. The item-level setting always takes precedence over the global default for that specific item.

Who can change the item-level setting

Role Can change embedding for
Administrator Any item in the application.
Item owner Their own items only.

 

5   Getting the embed code

Once embedding is enabled for an item, the embed code is available on the item's Embed tab in the Admin portal. The embed code is an iframe you can paste directly into any external page whose domain is on the whitelist.

Before copying the code, you can configure the player appearance:

Option Applies to Description
Player dimensions All media types Set the width and height of the embedded player.
Autoplay All media types Start playback automatically when the page loads.
Loop All media types Restart playback from the beginning when it ends.
Mute on load All media types Start playback muted.
Playlist item position Playlists only Display the video list to the right of or below the player.

For the full list of available player parameters, see What player parameters can I manage?

 

6   Sharing embed codes

In the Media portal, users can access the embed code for a video directly on its page, via the Share button below the player. From there, the code can be copied or sent by email.

This is controlled by a dedicated permission. To see and share an embed code in the Media portal, a user must have the Share Embed Code permission assigned to their role.

Administrators can assign the Share Embed Code permission to a role in Settings > Roles.
Note: The Share button only appears for items that have embedding enabled. If a user has the Share Embed Code permission but cannot see the Share button, check that embedding is enabled for that item — see Item-level embedding setting.

 

7   Troubleshooting

Symptom Likely cause What to do
"Embedding not permitted for this domain" The external site's domain is not on the whitelist. Ask an administrator to add the domain in Settings > Domain whitelist.
Player does not load on the external site (no error message shown) Embedding may be disabled at the item level. Check the item's General tab and enable Allow embedding on whitelisted domains.
Share button is not visible on the video page in the Media portal Embedding is not enabled for that item, or the user lacks the Share Embed Code permission. Verify the item's embedding setting, and check that the user's role has the Share Embed Code permission in Settings > Roles.
Newly uploaded items are not embeddable by default The global default is set to disabled. Enable embedding on each item individually via its General tab, or contact Ravnur support to change the global default.
Powered by Zendesk