Create a custom channel layout

Use this approach when the default Channel widget does not match your design requirements.

You still manage channels in Bambuser Workspace, but render the UI yourself using the Channels REST API.

Typical use cases:

• Custom card sizes and spacing
• Different number of cards per row
• Custom alignment and content order
• CMS-driven layouts and custom components

Default Channel widget limits

The widget has one fixed layout with limited styling options.

• Channel customization details: Create a landing page with Channels
• Example Channel implementation: Bambuser demo Channels page

Supported

• Colors
• Fonts
• Buttons
• Typography
• Section names and descriptions

Not supported

• Fully custom grid/card layout behavior
• Arbitrary card sizing rules
• Fully custom title/content placement

Use the Channels REST API

• Docs: REST API for Live - Channels
• Scope: READ_CHANNELS
• API key setup: Generating API Keys
• Base URLs:
  • Global: https://liveshopping-api.bambuser.com/v1
  • Europe: https://liveshopping-api-eu.bambuser.com/v1

note

Call this endpoint from your backend, not directly from client-side code.

GET https://liveshopping-api.bambuser.com/v1/channels/{channelId}

Response shape example

The response includes channel metadata and playlists (featured, scheduled, archived).

{
  "results": {
    "id": "pY0VZcLgMaM6JNaHRhLl",
    "title": "Channel 1",
    "previewImages": ["http://example-domain/path/to/preview.png"],
    "playlists": [
      { "type": "scheduled", "title": "Upcoming shows", "shows": [] },
      { "type": "archived", "title": "Ended shows", "shows": [] },
      { "type": "featured", "title": "Featured", "shows": [] }
    ]
  }
}

Use playlist data to render your own layout in your frontend.