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
- 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.
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.