Digital Assets: How to embed into a website or external web page – THRON Guide

Publish a video, image, or document on a website or web page without uploading duplicate copies elsewhere: the file remains a single entity managed on the Platform. When you replace it or update its data, all pages hosting it display the new version automatically.

Choose how to integrate it based on how much control you want over visual rendering.

What you want to achieve	Method
Display content using the THRON player, with playback controls and Content Experience	EMBED sharing
Integrate the file directly into your site markup, such as an `img` tag or third-party player	Delivery URL
Use the cover image of a video, for instance as a thumbnail in a listing	Thumbnail delivery URL

An Embed share provides ready-to-paste code: it brings the THRON player and your configured Content Experience, eliminating the need to write custom markup.

Generate embed code

Locate the Asset in list view or on the wall.
Open the Asset context menu via the three dots:
- in list view, click the three dots next to the thumbnail in the corresponding row;
- on the wall, hover over the thumbnail to reveal the three dots, then click them.
In the context menu, click on Share.
In the Sharing type window, select EMBED.
Click on Select.
Configure options in the EMBED Creation panel (see below).
Click on Update and generate EMBED code.
In the Embed code window, click on Copy embed code.
Paste the code into your page HTML exactly where you want the content to appear.

Note: you can also generate the embed code directly from the Asset details view.

Note: if you need to publish many Assets, do not generate an embed for each one. Link the folder to a Custom Application and use a single pKey for all contents: new Assets uploaded to the folder automatically become accessible with the same key.

Customize embed code

Option	What it does
Embed name	Identifies the share in your Shareboard. Max 500 characters.
Player template	Selects the Content Experience style with which the player is displayed.
Responsive player	Automatically fits player dimensions to the container page. When disabled, you can set Width and Height in pixels.
Show controls	Displays playback controls in the player. Enabled by default.

Note: to create new Player templates, go to Experience Manager in the settings menu next to your avatar in the top navigation bar.

Options for video and audio

Only for video or audio Assets:

Autoplay: starts playback automatically when the page opens.
Loop: replays continuously upon completion.
Mute: starts playback without audio.

Options for images

For image Assets, the following options are available:

Crop: No crop, Center crop, Auto crop, Product crop, or Manual crop (with custom coordinates and the option to enforce the player's aspect ratio).
Advanced settings: image adjustments such as contrast and saturation.

Recommended configuration

For most website use cases:

Responsive player enabled, so the player adapts to any column width without hardcoding pixel values.
Show controls enabled, giving visitors full playback control.
Autoplay disabled, respecting visitor browsing experience. If enabled, also enable Mute: modern browsers block autoplay with sound.
Player template aligned with the Content Experience across the rest of the site for visual consistency.

Integrate content without player, via Delivery URL

If you manage your page markup, you don't have to use the player: every Asset can also be accessed via a Delivery URL that you can place in an img tag, a download link, or a third-party player. Just like with embeds, content remains connected to the Platform and updates whenever the Asset changes.

Get an Asset URL

Open the Asset context menu via the three dots and click on Share.
In the Sharing type window, select URL.
Configure available options, then generate and copy the URL.

URL sharing also creates the pKey authorizing content distribution. You can view all created shares in the Asset Shareboard.

Retrieve a video cover image

The player displays the video, not its cover image. If you need the cover as a standalone image (e.g. as a thumbnail in a listing), compose the thumbnail Delivery URL:

https://<clientId>-cdn.thron.com/api/v1/content-delivery/shares/<pkey>/contents/<contentId>/thumbnail?w=1280

Where:

clientId: your THRON tenant identifier.
pkey: the authorization key. Use the one generated by a URL share or the Custom Application linked to the folder.
contentId: the Asset ID, found in the additional information section of content details.
w: the image width in pixels (optional parameter).

Note: the thumbnail is always delivered in the best format for the browser and center-cropped if necessary. To control cropping, quality, and adjustments, use an image Delivery URL rather than the thumbnail URL.

What happens if you modify or delete the Asset

Replacing the file or updating its data does not require regenerating embed codes or already published Delivery URLs: they remain valid and serve the updated version.

Attention: deleting the Asset causes the embed to stop displaying content across all pages where it was published. Before deleting an embedded Asset, check all hosting pages.

If embed does not work on your site

If the player does not appear or returns an error on a specific domain, the most common cause is a domain restriction configured at the account level. Contact THRON support to verify or update your domain whitelist.

## In-depth articles
- The pKey: What it is and how to manage it
- Guide to Creating and Configuring a Custom Application
- Digital Assets: How to remove and delete
- THRON Player: new version

Need help?

For technical issues, write to support@thron.com.

Channel Activation