Skip to main content
The CometChat Calls SDK provides three layout modes for displaying participants during a call. You can set the initial layout in call settings or change it programmatically during the call.

Available Layouts

Tile Layout

The default grid layout that displays all participants equally sized in a grid pattern.
Displays one main participant with other participants in a sidebar. Useful when focusing on a presenter or active speaker.

Spotlight Layout

Focuses on a single participant with minimal UI for others. Ideal for presentations or when one participant needs full attention.

Set Initial Layout

Configure the initial layout when creating call settings:

Change Layout During Call

Change the layout programmatically at any time during the call:

Listen for Layout Changes

Subscribe to layout change events:

Spotlight Mode Options

When using Spotlight layout, you can configure video tile interactions:

Pin Participant

Pin a specific participant to the main view in Sidebar or Spotlight layouts:

Automatic Layout Changes

The SDK automatically switches to Sidebar layout when:
  • A participant starts screen sharing
  • A participant is pinned
When screen sharing stops or the participant is unpinned, the layout returns to the previous state if it was programmatically set.

Complete Example