Documentation

Vimeo

Vimeo

Please note that currently it can take up to 3 minutes for your live stream to appear on your website.

Account Requirements

WP Livestream requires Vimeo Premium or above to work properly.

Get Your Vimeo User ID

  1. Go to https://vimeo.com/settings/account/general
  2. Copy your User ID.
  3. In your WordPress admin, go to Settings -> WP Livestream
  4. Click on the Vimeo tab.
  5. Paste the User ID you just copied into the Your Vimeo User ID field and click Save Settings.

Create a Vimeo App

  1. Go to https://developer.vimeo.com/
  2. Click “New app”.
  3. Choose any app name and description.
  4. Click the “Create App” button.

Generate Access Token

  1. In your app’s sidebar, click “Generate Access Token”.
  2. Select the “Authenticated (you)” option.
  3. Under Scopes, select the following options:
    • Private
    • Video Files
  4. Click “Generate”.
  5. Copy that access token.
  6. In your WordPress admin, go to Settings -> WP Livestream
  7. Click on the Vimeo tab.
  8. Paste the access token you just copied into the Your Vimeo Personal Access Token field and click Save Settings.

Copy your Client Identifier

  1. In your app’s sidebar, click “General Information”.
  2. Copy the Client Identifier.
  3. In your WordPress admin, go to Settings -> WP Livestream
  4. Click on the Vimeo tab.
  5. Paste the Client Identifier you just copied into the Your Vimeo Client ID field and click Save Settings.

Copy your Client Secret

  1. In your app’s sidebar, click “Manage App Secrets”.
  2. Copy the Client Secret.
  3. In your WordPress admin, go to Settings -> WP Livestream
  4. Click on the Vimeo tab.
  5. Paste the Client Secret you just copied into the Your Vimeo Client Secret field and click Save Settings.

If you are having any issues, please contact support.


Troubleshooting Common Issues

Basic checklist

Here are a few initial things to check if your livestream is not being picked up by WP Livestream:

  1. The first things to check are the privacy settings on the video itself (https://vimeo.zendesk.com/hc/en-us/articles/224817847-Privacy-settings-overview) as well as the settings on the live event (https://vimeo.zendesk.com/hc/en-us/articles/360001205427-Changing-the-privacy-settings-of-your-Live-videos)
  2. Ensure that your video does not have the privacy setting “Password,” enabled.
  3. Ensure that your video does not have the privacy setting “Only me,” as only you (the owner) and your team members will be able to watch your video embedded on your website.
  4. Check that your domain has been added to the allowed domain list for embedding. See https://help.vimeo.com/hc/en-us/articles/224819527-Changing-the-privacy-settings-of-your-videos

Once you have checked the above, we recommend first manually embedding a stream to double-check that your Vimeo account is allowing embeds.

As long as the privacy options for video embedding are set to Anywhere or Specific Domains (and you’ve added the correct site domain) then your app should be allowed to access it and embed.