How to add a Brightcove-hosted video to a session

Available for:

  • Engage
  • Captivate
  • Enterprise (Events)

This Article Covers Steps to Add a Brightcove Video to Your Pigeonhole

  • Step 1: Setting up Pigeonhole player in Brightcove
  • Step 2: Configuring the Brightcove plugin
  • Step 3: Getting Brightcove video code
  • Step 4: Adding the code to your Pigeonhole

Note: You can add only one Brightcove video per session.

Step 1: Setting up Pigeonhole player in Brightcove

Add Player.gif

  1. Navigate to “Players” screen in Brightcove
  2. Then click “Add Player”
  3. Next, enter “Pigeonhole-player” in the name field
  4. Finally, click “Save”

Step 2: Configuring the Brightcove plugin

Creating Plugin.gif

  1. Click into the “Pigeonhole-player” you just created
  2. Next, under “Player information” click “Plugins”
  3. Then click “Add Plugin” and select “Custom Plugin”
  4. Name your plugin “phl”
  5. Now copy this link -
  6. Then paste in “JavaScript URL” field
  7. Finally, click “Save”

Step 3: Getting Brightcove video code

Embedv Video - New.gif

Note: You will want to ensure the video you want to use is uploaded into Brightcove. 

  1. Navigate to “Media”
  2. Then select the video you would like to add to your Pigeonhole
  3. Now click “Publish and embed” then “Publish to web” from the dropdown menu
  4. Under “Select Player” choose the player you created in the previous step (Pigeonhole-player) from the dropdown menu
  5. Scroll down to the embed code
  6. Under “Change player size” select “Fixed”
  7. Finally, copy the embed code

Step 4: Adding code to your Pigeonhole

Adding Code to PH.gif

  1. In your Pigeonhole, navigate to “More settings”
  2. Select the “Integrations” tab
  3. Now click the “Integrate” button next to the Brightcove option
  4. In the popup window, select the Session you would like to add your video to
  5. Next, paste your copied embed code into the “Embed code” field
  6. Finally, click “Add Video” to save your video

Note: For your code to work correctly, you will need to remove the extra line spaces in the embed code. If you receive an error message, please review the code for extra spaces. 

The final code should look something like this:

<iframe src="" allowfullscreen="" allow="encrypted-media" width="960" height="540" </iframe>

Tip: Use Test Mode to see how your integration looks on the Audience Web App from your audience's perspective.