Skip to main content

Promoted Shows

The Bambuser player has a built-in promoted shows carousel that surfaces other live or upcoming shows to viewers while they watch. You can control its visibility using the ui.hidePromotedShows configuration flag.

The promoted shows carousel is visible by default. Pass "hidePromotedShows": false explicitly to confirm it is enabled, or true to hide it.

let config = BambuserVideoConfiguration(
type: .live(id: "your-show-id"),
events: ["*"],
configuration: [
"autoplay": true,
"currency": "USD",
"locale": "en-US",
"buttons": [
"dismiss": "event"
],
"ui": [
"hidePromotedShows": false, // true = hide the promoted shows carousel
]
]
)

UI Configuration Reference

Both flags belong under the "ui" dictionary in your player configuration:

Config KeyTypeDefaultDescription
ui.hidePromotedShowsbooleanfalseHides the promoted shows carousel inside the player.
ui.hidePlaybackRateButtonbooleanfalseHides the playback speed button.

ℹ️ All ui.* flags must be nested under the "ui" dictionary, not placed at the top level of configuration. See Configuration and Functions for the full UI configuration reference.

Hiding All Optional UI Elements

To present a minimal player with no optional UI elements:

configuration: [
"buttons": [
"dismiss": "none"
],
"ui": [
"hideEmojiOverlay": true,
"hideActionBar": true,
"hideShareButton": true,
"hideClosedCaptionsButton": true,
"hideVolumeButton": true,
"hidePlaybackRateButton": true,
"hidePromotedShows": true
]
]