We've compiled some of the most common questions and tips we receive about Whereby.

You can check for service outages and issues on our status page:

We're currently aware of an issue with users running Avast antivirus. The "Avast Web Shield" feature conflicts with sites using port 443 and can cause video feeds to appear as black frames in Whereby. We're working with Avast on a way for them to account for this in their platform, however to resolve Whereby related issues you'll need to disable that feature. Avast Support Article

Tips & Tricks

Firewall Settings

To use Whereby behind a firewall, a network administrator will need to adjust the settings. Port 443 will need to be open to all TCP and UDP traffic. Some enterprise firewalls require more in depth technical information for proper allowance, please contact your Customer Success Manager or embedded@whereby.com

Testing Whereby rooms embedded on your platform

We always recommend testing Whereby in an incognito/private browser if possible. If you are logged into your Whereby account, the admin permissions can override some of the features set via parameter or dashboard.

Connections in UAE, China, and Russia

We're aware of restrictions that have been put in place for peer to peer applications like Whereby. In these areas we've had reports from users that they have spotty access to Whereby, or that the service doesn't work for them at all.

Unfortunately, because these are government-level restrictions that have been put in place on the internet, there isn't anything we can do to address issues like this at this time.

Common Questions

Can I remove the Powered by Whereby banner in my rooms?

Yes! The powered by Whereby is automatically removed when you upgrade to a paid plan. You can review our pricing options and upgrade via the "subscription" option on your dashboard!

How many people can be in a room/meeting?

When creating a room you can specify two different modes, normal and group. Normal has a capacity of 4 and group has a capacity of 200. There is a limit of 24 active cameras at one time in any meeting room.

When using viewerRoomUrls you can have an additional 400 passive users within the room for a more "webinar" style setup.

What is the video quality in Whereby?

We support up to 720p with 30fps at both 4:3 and 16:9 aspect ratios for video.

Screen sharing will broadcast from 1-5 FPS (frames per second) by default, and up to 1080p based on network and CPU restraints.

Can I customize the page users see when they leave a room?

Yes! When using our Web Component, you'll have access to "leave" browser event. You can then action on that event to redirect your users to another page of your choosing.

URL parameters aren't working as expected
  1. The most common error we see relating to URL parameters is incorrectly using "?" twice in the meeting room URL. Combining parameters can be achieved by using the ampersand symbol (&) for example: ?minimal&screenshare=off.

  2. If the person using/testing the room is also logged into their Embedded account, it will override any parameters added to the room URL. Try accessing the room via a private or incognito window to verify your links are working as expected.

Can I create longstanding meetings?

Yes! You can create meetings with endDates far in the future (eg. A month or multiple months). Please keep in mind that if you are providing any of your users with hostUrls, you won't be able to revoke host access from those users.

My hosts/viewers don't have the correct meeting privileges
  1. Host or Viewer privileges will only be available while the room is active and until 1 hour after the meeting's endDate

  2. Check your hostRoomUrl or viewerUrl to make sure you've properly separated the roomkey and other parameters with "&"

How do I enable integrations in my meetings?

Integrations are disabled for Whereby Embedded by default while using the ?minimal parameter. We set this by default because Content Security Policy restrictions can sometimes cause integrations to fail in unexpected ways. Currently only our YouTube and Miro integrations will work in an embedded setting.

If you would like to test an integration in your embedded meeting, you can do so by adding the ?roomIntegrations=on parameter.

Please note, we offer limited support for integrations in an embedded meeting, even when enabled. It's highly recommended that you test before using it in a production context.

CORS Policy Error in the browser console

In some cases you may experience an error in your browsers developer console that looks something like this:

Access to fetch at "https://api.whereby.dev/v1/meetings' from origin S° nas WithOutLoginMult:1 been blocked by CORS policy...

You need to access the Whereby API from a server environment or computer. You aren't allowed access to the API via the browser console because it would expose your secret API key.

Last updated