Rate this page:

Video Composer Changelog

1.2.0 (December 17th, 2021)

New Feature

The identities of participants can now be hidden in the Video Composer. To enable this feature, pass the following variable to the ExtensionEnvironment parameter when creating a MediaProcessor:

  // Prevents participant identities from being displayed in the Video Composer (optional, false by default)
  "hideParticipantIdentities": true

1.1.0 (December 17th, 2021)

Presentation Mode

The Video Composer now supports Presentation Mode! This allows participants to "present" content of their choice to the other participants and viewers. To present a video track in your application, enable a user to publish a video track with the name video-composer-presentation. The Video Composer will show the presented video as the largest track on the screen, and the list of speakers will move to the right of the presentation. Please note that this list will only show 5 speakers at a time, and they will update as the active speaker changes.

Additional Details

  • The Video Composer will only show one video track named video-composer-presentation at a time in the main view. If a video-composer-presentation track is already being shown in the main view, then subsequent tracks named video-composer-presentation will not be rendered. Applications should limit the publishing of a video-composer-presentation track to one per room to avoid potentially unexpected UI/UX states.
  • The Video Composer presentation mode is only supported with video tracks named video-composer-presentation. Audio and data tracks published with the name video-composer-presentation will not result in any Video Composer UX changes.
  • The Video Composer will return back to the adaptive grid view layout when an application unpublishes a video track named video-composer-presentation shown in the main view.


  • Updated the color palette of the video composer to have a neutral gray theme.

1.0.0 (October 20th, 2021)

The 1.0.0-beta.1 Video Composer has been promoted to 1.0.0 and is now Generally Available! Thank you for all the feedback from our beta customers. For more details about the Video Composer, please visit the documentation.

1.0.0-beta.1 (October 13th, 2021)

A media extension that composes a Programmable Video Room's participants in an adaptive grid layout.


  • Automatically connects to and disconnects from a Programmable Video Room. The video composer disconnects from the Room if no participants have connected after 5 minutes.
  • Composes a Room's participants into an adaptive grid layout with a maximum of 9 participants. When the Room contains more than 9 participants, the Video Composer shows the 9 most recent active speakers. If a speaker not shown becomes the active speaker, the Video Composer will automatically add the new speaker to the grid in place of the least recently active speaker.
  • Automatically highlights the current active speaker.
  • Automatically shows audio and video muted indicators.

Getting Started

To use a Video Composer in a Twilio Live application, specify the Video Composer extension name and extension context parameters when creating a MediaProcessor.

curl -X POST '' \
  -d 'Extension="video-composer-v1"' \
  -d 'ExtensionContext={"room": {"name": "RM123"}, "outputs": ["VJXXX"]}'

Extension Context

The snippet below describes the Video Composer extension context parameters.

  // Room Parameters (required)
  "room": {
      "name": "RM123", // required

  // Extension Identity (optional, video-composer-v1 by default)
  "identity": "video-composer-v1",

  // Media destinations (required)
  "outputs": ["VJXXX"],

  // Audio bitrate (optional)
  "audioBitrate": 128,

    // Resolution (optional)
  "resolution": "1280x720"
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more