Using Whereby's Web Component & Pre-built UI

The Web Component offering in our SDK allows you to leverage the thoughtfully designed, pre-built Whereby interface and user experience we've developed over the last 10+ years.

Below are a few examples of how you can use some of the client events and commands that can be sent to a room. We have information on how to get started and install, but for a full document about events, attributes, and commands you can view our Web Component Reference documentation.

pageWeb Component Reference


When using React or a bundler like Webpack, Rollup, Parcel, etc. you can install the Whereby Browser SDK in your project using npm:

npm install

You can then import it as follows:

import ""

And embed your room using our <whereby-embed> web component:

<whereby-embed room=""></whereby-embed>

You can use a hostRoomUrl instead of the roomUrl, if you want to give the user host privileges

If you aren't using a bundler or a library containing a bundler you can access the component code directly from our CDN using a simple Script tag in your site

Listening to events

You can listen for events on the <whereby-embed> component. Here are a few examples how the events might be useful, but there are lots of creative ways these might be useful! Let us know in an email or our discord how you've implemented these.


When a user leaves the room, you can redirect them to a page of your choosing

const whereby = document.querySelector("whereby-embed");

whereby.addEventListener("leave", () => location.href = "")


Keep track of the number of participants in a room. Once a room has reached its capacity (200 participants), you can swap the room source URL to a viewerRoomUrl for additional capacity.

const whereby = document.querySelector("whereby-embed");
let participantCount = 0

function logEvent(event) {
    participantCount = event.detail.count
whereby.addEventListener("participantupdate", logEvent, { once: true }) // Adding the once option prevents repetitive refreshes

if(participantCount <= 200){ = ""
} else { = ""

A few other ideas:

  • Display an in app greeting banner whenever there is a new participant_join event

  • Display an in app message directing users to certain support documentation whenever they accidentally deny_device_permission

  • Make a log for support or success teams if a user frequently experiences connection_status_change errors so they can proactively reach out and investigate connection issues

Sending commands

For this feature to work, you must add the origin of your application to the "Allowed domains" section on your Whereby dashboard. If not present, the following methods will not function.

The <whereby-embed> web component exposes a set of methods your application can invoke to perform actions in the room.

For example, using a URL parameter you can hide the bottom toolbar and create your own buttons for taking actions in the room:

const whereby = document.querySelector("whereby-embed");
<whereby-embed floatSelf background=off displayName="Rick Astley" room=""></whereby-embed>

<button onclick="whereby.toggleCamera()">CAMERA</button>
<button onclick="whereby.toggleMicrophone()">MIC</button>   
<button onclick="whereby.toggleScreenshare()">SCREENSHARE</button>
<button onclick="whereby.toggleChat()">CHAT</button>

Last updated