Whether you are streaming a one-time event or a recurring event, you can embed the live player and viewer chat onto your website. The embed is an iframe code, which most website hosting services support.
In this article:
- How to embed your event
- Hide your live viewer count
- Hide Live label on your events
- My website editor has a video widget, can I use that?
How to embed your event
- First, create your event from the video manager.
- When you get to the Live Settings page, select the Embed tab if you are streaming a one-time event, or the Event tab if you are streaming a recurring event.
- Before grabbing the embed code, check the various settings here and customize them as desired. Note that at this time, there are some differences in the options available between one-time events and recurring events.
To the right of the embed customization settings is a preview of what your embedded player will look like. Below the preview is the ability to add a custom thumbnail, adjust your event's start time, and show your event's schedule (overlay in the lower-left corner). Note that, aside from the thumbnail and the start time, the settings on this page only impact the embedded player and not the event page on vimeo.com.
- Once you’ve configured your embedded player settings, click Event embed code; this will open a modal with the iframe code and the embed’s size settings.
- Choose between Responsive, where it will adjust based on the container size, or Fixed, where you can input the height and width in pixels.
- You can then copy the iframe code to your clipboard and paste it into your website’s HTML editor.
- The player will appear on your site. If you wish to include your event’s chat on your website in addition to the player, click Chat embed code on the embed settings page to copy the code and paste it into your website. In this example, the embedded chat is below the embedded player.
Note: The chat embed also includes Q&A and Polls.
When your stream is not active, the embedded player will display a message (e.g. “This event has not started yet.”) The embedded chat will be active as soon as you enable it on the Live Settings page, allowing your viewers to start chatting. While the chat on vimeo.com pages does not work on mobile browsers, the embedded chat does work for both desktop and mobile viewers.
When you start your stream, the player will automatically load.
When you stop your stream, the player will indicate the event will be archived and the chat embed will indicate that it is offline.
Hide your live viewer count
In order to hide your live viewer count for your embedded live streams,
- Go to your event’s settings page.
- Select the Appearance tab.
- Scroll down to the Customization option.
- Select Hide Viewer Count.
This setting will disable the live viewer count for all future embedded live streams for that event.
Note: Each new live event will inherit the state of a similar toggle from the account settings. If this option changes in account settings, it won’t apply to existing live events.
If the state of the toggle changes for a specific recurring live event, then each new live stream will inherit this setup and this live event won’t respect the setting in account settings anymore.
Hide Live label on your events
While live-streaming your event, you can select to hide/display the Live label on the players of your live events.
In order to disable the Live label from your live streams, you can select “Hide Live label” from the Customization option on the Appearance tab on your event settings page.
Note: Broadcasters will have to disable the live label in order to hide it on their live events, as the live label appears on all live events by default.
Embed Customization
Because of the nature of the two event types, there are a handful of differences in the embedded player.
The table below details each embedded player feature and for which event type it is available.
|
Feature |
Recurring Event |
One-time event |
|
Show recurring schedule - a lower-left corner overlay that displays the next time the event will be live. |
Yes |
No |
|
Show event schedule - Choose whether or not to display the date and time of the upcoming event along with the default "This event has not started yet" message in the middle of the player. |
Yes |
Yes |
|
Show latest video when off air - Instead of displaying the next start date, the player will show a thumbnail and play button for the last stream on this event. |
Yes |
No; the event embed by default becomes an embed of the stream archive. |
|
Show playlist - an upper-right corner overlay that allows for navigating between all videos on this event. |
Yes; when enabled, this will override displaying the event title. |
No |
|
Autoplay - when watching a video in the playlist, the next video will start playing as soon as the current video ends. |
Yes |
No |
|
Loop playlist - when the last video in the playlist ends, the first video in the playlist will automatically begin. |
Yes |
No |
|
Play bar - display the play bar, which shows the elapsed time of the event. Some other elements cannot be displayed if this is disabled. |
Yes |
Yes |
|
Volume control - allows viewer to adjust player volume (requires play bar). |
Yes |
Yes |
|
Fullscreen button - allows viewer to watch in fullscreen mode. |
Yes |
Yes |
|
Like button - Viewer can “like” the video on Vimeo. |
No |
Yes |
|
Watch Later button - Viewer can add the video to their Watch Later list |
No |
Yes |
|
Share button - Viewer can share the Vimeo URL to social channels and by other means. |
No |
Yes |
|
Your details (Portrait, Title, Byline, Let users decide) - This information is pulled from your Vimeo account and can overlay the upper left corner. |
Title only; when enabled, this will override displaying the playlist. |
Yes |
|
Customization (Customize color, Show Vimeo logo, Display Custom logo) - Displaying any logo requires the play bar to be enabled. Custom logos can be hidden during live playback and can link to a website. |
Yes |
Yes |
|
Interaction tools - Email capture and end screens (Thumbnail and Call to action).
|
No |
Yes |
My website editor has a video widget, can I use that?
Some website hosting services such as WordPress or Church Online include tools and plugins to help simplify adding content to your website, such as a video widget that allows you to paste the URL of your video or event and automatically embeds it in the body of your site.
While this method of embedding works for one-time events, this currently cannot be done for recurring live events. If you need to embed your recurring live event, we recommend using an HTML block and pasting the iframe code from your recurring event as described above. If an HTML bock or widget is not an option, consider using a one-time event instead.