Blog

Camera not working? How to test your webcam and fix it

· Andrij Tkachenko · 4 min read

A webcam on a stand with a magnifying glass over its lens and a small wrench beside it

To find out why a camera isn't working, test it on a page that does nothing else: open our webcam test and press Start camera. If a picture appears, your camera and browser are fine and the problem is in the site or app of your call. If not, the test tells you which of the causes below it found.

It takes a few seconds and there is nothing to install. The picture stays in your browser, with nothing recorded or sent anywhere, and the camera turns off when you stop it or leave the page.

The site is blocked

The browser asks each site for permission once, and remembers the answer. If it was refused, the site can't ask again, so you have to change it yourself:

  • Chrome and Edge: click the icon at the left of the address bar, set the camera to allow, and reload the page.
  • Firefox: click the permissions icon in the address bar, remove the block, and reload.
  • Safari on a Mac: open the Safari menu, choose Settings for This Website, and set the camera to allow.

If the browser never asks at all, the block is usually in your system.

Your system blocks the browser

A browser can only use a camera when the system lets it. Each system keeps its own list:

  • Windows 11: open Settings, then Privacy & security, then Camera. Turn on camera access, access for apps, and access for desktop apps.
  • Mac: open System Settings, then Privacy & Security, then Camera, and turn it on for your browser. Restart the browser afterwards.
  • iPhone and iPad: open Settings, then Apps, then Safari, and set the camera to ask or allow. On older versions, Safari is directly in Settings.
  • Android: open Settings, then Apps, then your browser, then Permissions, and allow the camera.

On a computer your workplace manages, an administrator may have turned the camera off. No setting of yours will change that, so ask them.

Another app is using it

A camera often serves one app at a time, especially on Windows. Close other video call apps and any browser tabs that might be holding the camera, then try again. If it still won't start, restart the browser, and then the computer, as a program that crashed can keep hold of it.

The camera isn't found

If the test finds no camera at all:

  • Check the cable, and plug it straight into the computer instead of a hub. Try another USB port.
  • On a laptop, look for a switch on its side or a key with a camera on it.
  • On Windows, open Device Manager and check that the camera is listed under Cameras, without a warning sign.

The picture is black

A black picture with frames still arriving usually means the lens is covered. Look for a small sliding shutter over the camera, on the camera itself or on a laptop's lid, and for a privacy cover stuck on it.

A browser reports a covered camera as a working one, so most pages show you nothing but black and no reason. Our test looks at the picture itself and tells you.

The picture is poor or jerky

The test shows what your camera really delivers, which can be well below what its box promises:

  • Low resolution. The browser asks for a size and the camera gives the nearest it can. A slow USB port, a long cable or another app using the camera can bring it down. Pick a larger size in the test to see what it can do.
  • Low frame rate. A steady 24 to 30 frames a second looks smooth. Low light is the usual reason for less, as the camera holds each frame longer to gather light, so turn a lamp on and face it.

The wrong camera shows

Computers often list several cameras, and some are virtual ones that other apps add. Pick another in the list beside the picture in the test. Then choose the same one in the settings of your call, as each site remembers its own.

It works here but not in your call

If the test shows a picture and your call doesn't, the camera is fine and the fault lies with that one site or app:

  • Each site has its own permission, so the site of your call may still be blocked.
  • It may be using a different camera, so check its own device settings.
  • It may be an app with its own entry in your system's privacy list, apart from the browser.
  • Leave the call, reload the page and join again.

If you are helping someone else, send them the webcam test, which needs no account. If their camera works and the call still fails to connect at all, the cause is more likely the network, which the WebRTC test checks.

For developers: what your page can see

A browser only lets a page use a camera over HTTPS, or on localhost while you develop. On a plain http:// page, navigator.mediaDevices isn't there at all.

getUserMedia() also says what went wrong by the name of its error, so your page can tell people what to do:

  • NotAllowedError: the person or the system refused.
  • NotFoundError: there is no camera, or none that fits what was asked for.
  • NotReadableError: the camera is there but can't start, most often because another app holds it.
  • OverconstrainedError: no camera can meet a requirement such as an exact size, so ask with ideal in place of exact.

A video call has more to get right than the camera, as how to implement video calls in Next.js and how group video calls work show. The call screen in our SDKs for video calls deals with permissions and switching devices for you, and the docs on calls show how to add it.