The videos you have uploaded will be shown on your video website automatically as soon as you have published them and placed them in a category, without the need for you to do anything else. If you have set up automatic distribution to e.g. social networks or YouTube, this will happen automatically as well.
But you may also want to put your video content on other sites, your main website or for use in campaigns on external websites. For this, each of your videos have an embed code that you can copy and insert on any web page and in this way you can have your video be playable wherever you want – in your branded video player.

Copying the embed code

To find the embed code for one of your videos, click on the video in the backend of your video website. To the right of the video preview, you will find a button which says “< > Embed”. By hovering over this button, you can select "Copy embed code" to copy the embed code with your default player and settings, or "Embed options" to configure and construct your embed.

If you copy this embed code and paste it into a web page, the video will be inserted and playback with the player and the settings you have configured.

Construct player embed

You have three settings to configure when constructing a player embed code: Which player you wish to use if the video should play automatically, and what happens when the video ends.

If you have more than a single video player, you can choose exactly which one you want to embed. Click on “Default player”, and a drop-down menu will appear. In this menu, find the video player that you wish to use.

Use the toggle to choose whether you want the embedded video to autoplay or not, and click on the drop-down to select how the video should end; either by the player’s default ending mode, showing sharing possibilities, showing recommended videos, looping through recommended videos, or ending on the video’s thumbnail.

When you make changes to your player embed, you will see the embed code update and also the preview of the player change.

Adding custom embed parameters

Besides using the default embed options you can manually customise how an embedded video looks and behaves without having to change the player settings. Parameters are to be added within the iframe - parameters include but are not limited to the examples below.

• Hide/show video title - showDescriptions=<0|1>
• Hide/show logo - showLogo=<0|1>
• Hide big play button - hideBigPlay=1
• Hide/show sharing options - socialSharing=<0|1>
• Hide/show recommendations - showBrowse=<0|1>
• Disable/enable looping - loop=<0|1>
• Hide/show controls - showTray=<0|1>
• Disable/enable auto play - autoPlay=<0|1>
• Disable/enable automatic muting if autoPlay is blocked - mutedAutoPlay=<0|1
• Disable/enable auto mute - autoMute=<0|1>
• Set starting point of video - start=<seconds>
• Set default quality of video - defaultQuality=<standard|hd|fullhd>
• Autoplay, loop and mute video with hidden controls - ambient=<0|1>
• Hide/show subtitles by default - subtitlesOnByDefault=<0|1>
• Set default subtitle language - defaultLocale=<locale>

Below, you can see an example of an embed code, and how two embed parameters have been added into the iframe by appending them to the iframe source URL (&showDescriptions=1&autoMute=1).

<div style="width:100%; height:0; position: relative; padding-bottom:56.25%"><iframe src="https://video.twentythree.com/v.ihtml/player.html?token=a72a0b0d2f9e9fce09658e006049f1c0&source=embed&photo%5fid=62406087&showDescriptions=1&autoMute=1" style="width:100%; height:100%; position: absolute; top: 0; left: 0;" width="100%" height="100%" frameborder="0" border="0" scrolling="no" mozallowfullscreen="1" webkitallowfullscreen="1" allowfullscreen="1" allow="autoplay; fullscreen"></iframe></div>

A link to the video

Under “Link” you can get a link to the video (in contrast to embedding the video itself). If the video is published, you will see the public link to the video here. If the video is not published, you will only see a secret link to the video.

The public link will direct your viewers to the video’s public landing page. With a public link the video will become available on your video hub and for search engines to index. This means the video can be viewed by anyone unless you have set restrictions for your video.

Sometimes you might want to have a few people watch and approve a video before it is published. If they have access to the backend of your video marketing platform, naturally they can watch it there, but if they do not have access, you can use the video’s “Secret link” to make the video available to them without it being published. The secret link directs to a page where the video is embedded and playable, even if it is not yet published. This page is not publicly available, and search engines do not index it, so the only way to reach it is to know the exact URL of the secret link.

Embed a video in an email

You can create embed codes specifically used for your email newsletters. This allows you to embed either a thumbnail with a play button or an animated thumbnail showing a few seconds of the video as a .gif image file.

In order to create the embed code you need to select the right email provider. If your provider is not on the list, choose “Paste into mail” creating a generic HTML code to use in all email clients. 

After selecting the right provider you can copy paste the embed code from the input field and use it in your newsletter.
If you want to create an animated thumbnail instead choose “Animated thumbnail” and the thumbnail image will turn into an animated gif. You can then copy paste the embed code or create your own animation in order to select the exact right part of the video to show.

To modify the animation click “Edit animation” and a popup of the video will appear with a timeline. You can now drag the beginning and end point on the timeline to select the animation. The video will keep looping so take your time to find the perfect spot. In order to keep the file size low and the quality high we suggest the animation should be around 5 seconds long. When you are satisfied with the result remember to click save to update the embed code.

After the animation is saved remember to copy paste the new updated embed code in your newsletter.