Embedding and linking your videos
When you upload a video to TwentyThree, it automatically becomes available in your Video Section as soon as it is published and assigned to a category. Any automatic distribution settings, such as sharing to social networks or YouTube, will also activate. Additionally, if you want to display your videos on other sites or campaigns, embed codes make this easy.
Copying the Embed Code
To embed a video, navigate to the video you wish to use and click Copy Embed Code for the default player code. For additional customization, click Embed Options, where you can select a specific player or generate a code for email use. Once selected, simply copy the embed code and paste it into your desired web page or CMS to display the video.
Constructing Player Embed Settings
When embedding a video, you can configure:
- Player Selection: Choose from your custom players.
- Autoplay: Enable or disable autoplay.
- Ending Behavior: Options include sharing, recommended videos, looping, or displaying the video thumbnail.
Adjustments in the settings will update the embed code and show a preview of the player.
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>
Sharing Links to Videos
Under the Link section, you can retrieve either:
- Public Link: Available for published videos and indexed by search engines.
- Secret Link: Allows sharing unpublished videos with selected viewers without making them publicly available.
The Public Link takes viewers to the video’s public landing page, where it is displayed within your Video Section. From there, viewers can browse suggested videos or navigate to the main page of your Video Section. This setup is ideal for encouraging discovery and engagement with your video library. If your goal is to limit access to a specific video, consider using a Secret Link instead. The secret link directs viewers to a page where the video is embedded and playable, even if it hasn’t been published. This page is private, unlisted, and not indexed by search engines, making it accessible only to those who have the exact URL. This option is perfect for sharing content discreetly while maintaining control over its visibility.
Embedding Videos in Emails
To embed videos in newsletters, use an email-specific embed code. Options include a static thumbnail with a play button or an animated thumbnail (GIF). Customize animations by selecting a 5-second segment from the video. This ensures a balance between file size and quality. Once satisfied, save and copy the updated code for your email client.
With these tools, you can share your video content seamlessly across platforms while maintaining control over its appearance and functionality.