When Enable URL navigation is turned on in the Channel General settings, the Channel reads a set of query parameters from the page URL on load. This makes it possible to share a direct link to a specific video within a Channel (for example, to link from an email or social post straight to a particular clip).
The parameters are added to the URL of the page where the Channel is embedded, not to the Channel’s embed code itself.
1.0 | Available parameters
| Parameter | Required | Description |
|---|---|---|
bb_ch_bid | Required | The ID of the player block in the Channel that should load the video. |
bb_cid | Required | The media clip ID or playlist ID of the content to load. |
bb_ctype | Optional | The content type. Use mediaclip (default) for a single video, or cliplist for a playlist. |
bb_t | Optional | The playback position to seek to on load. See section 1.1 for supported formats. |
bb_ch_bid and bb_cid must always be used together. Providing one without the other has no effect.
1.1 | Seek to a specific time
The bb_t parameter supports the following time formats:
| Format | Example | Result |
|---|---|---|
| Seconds (plain number) | 90 | 1 minute 30 seconds |
| Seconds with suffix | 90s | 1 minute 30 seconds |
| Minutes and seconds | 1:30 | 1 minute 30 seconds |
| Hours, minutes and seconds | 1:30:45 | 1 hour 30 minutes 45 seconds |
| Verbose format | 1h30m45s | 1 hour 30 minutes 45 seconds |
2.0 | How to find the block ID
The easiest way to find the necessary IDs is to click the “Share” button in the player while playing the clip in the Channel:
Alternatively, you can find the block ID (bb_ch_bid) in the Channel’s configuration. To find it, open the Channel’s JSON configuration in your browser:
https://[publication].bbvms.com/ch/[channel-id].jsonIn the JSON, look for the blocks array. Each block has an id field. Use the id of the Player block — this is the block type that supports pre-loading a video via URL parameters.
3.0 | Example
The following example opens the page with a specific video loaded into the player block with ID player-abc123, starting at 45 seconds into the video:
https://www.yourwebsite.com/video-page/?bb_ch_bid=player-abc123&bb_cid=1234567890&bb_ctype=mediaclip&bb_t=454.0 | Limitations
URL parameters can only pre-load content into a Player block. It is not possible to use a URL parameter to scroll to a specific swimlane, carousel, slider, or grid section. For that use case, the viewer would need to scroll manually after arriving on the page.