Jitsi virtual background or blur is missing

Short answer

First identify the client: desktop web, mobile browser, native app or embedded mobile SDK. Jitsi's web background controls and a native SDK's camera effects are different implementations. In the October 2026 SDK request, a maintainer said native effects need their own implementation and gave no delivery estimate. A web setting is not proof of mobile support. [S1][S2]

Identify the client before searching for a flag

A phone can run Jitsi in a browser, the stock native app or another application’s embedded SDK. Do not assume a web feature is available in each of those environments. The October 2026 SDK request asks for virtual backgrounds and blur on native platforms; the maintainer said a native implementation is needed and supplied no estimate. [S1]

Client What this review establishes What you must verify
Desktop web A web implementation and configuration gate exist in the pinned source. [S2] Your actual browser, device, deployed configuration and effect result
Mobile browser It is a browser context, not proof of the native SDK’s features Exact browser/device capability and the meeting’s controls
Stock native app Its shipped client determines available camera effects Exact app version and its current supported features
Custom Android/iOS SDK app The upstream request describes a native implementation gap. [S1] Exact SDK, any host-app custom effects and released documentation

This is an evidence and diagnostic table, not a device-tested compatibility matrix.

Check ordinary camera video first

Recommended sequence:

  1. Join a disposable meeting with the intended client and confirm ordinary camera video without effects.
  2. If that fails, follow camera diagnostics first.
  3. If video works, identify whether the background control is missing, disabled, or fails only after selecting an effect.
  4. Compare the same client/build with the operator’s supported configuration. Avoid changing the server and the device at the same time.

A missing menu and an effect-processing failure are different symptoms; neither is established as a bridge-port problem by this source review.

For desktop-web operators

The reviewed 11248 helper treats config.virtualBackground.disabled === true as disabled. Preserve the organization’s intended policy and check the merged configuration actually delivered to the browser, rather than only a host-side file. This gate does not establish every other capability required by an effect. [S2]

For Docker, follow the normal custom-config workflow; package operators should inspect their installed web configuration. Use custom configuration diagnostics if changes do not appear. A tutorial for a different release is not proof of your client’s controls.

Once the control is available, test the resulting video with another participant. Verify the effect remains applied when the camera is toggled and after an ordinary rejoin. These are recommended acceptance checks, not completed tests from this review.

For mobile SDK developers

Read the current SDK’s feature documentation and the maintainer discussion before promising browser-equivalent effects. Adding a web config option to a native integration does not implement the native camera-processing feature discussed in issue #17967. The reviewed discussion supplies no delivery schedule. [S1]

If your host app supplies a custom effect, document that implementation and test it with the exact SDK/device combination. Do not describe a host-app customization as a feature available in every stock Jitsi client.

For immediate meetings, use a client whose supported features meet your needs, or continue with ordinary camera video and an appropriate physical background. Those are alternatives, not a repair of the missing implementation.

Open questions and maintenance

Reviewed 24 October 2026 against Jitsi Meet 11248 source f765042 and the then-open native SDK request. We did not run background processing on a browser, phone, native app or SDK. No performance, device or image-quality guarantee is established. Recheck the exact release and issue status before changing the capability table or promising native availability. [S1][S2]

Sources

Written by the Jitsi Help engineering team

Jitsi infrastructure engineers who deploy and run Jitsi Meet servers in production. Last updated . How we write our guides

Stuck on something this page does not cover? Ask a question below. Jitsi Help engineers read every one.

Did this fix it?

Something on this page is outdated or wrong?

Collect debug info

These commands gather what an engineer needs to diagnose a Jitsi server. Copy them, run them, and keep the output.

Terminal
# Run on the server, from your docker-jitsi-meet folder

# 1. Every service should be "running" (or "healthy")
docker compose ps

# 2. Which images and release tags are running
docker compose images

# 3. Recent logs from the core services
docker compose logs --tail=200 web prosody jicofo jvb

# 4. The settings most fixes depend on
grep -E '^(PUBLIC_URL|JVB_ADVERTISE_IPS|ENABLE_LETSENCRYPT|ENABLE_AUTH|AUTH_TYPE)=' .env

# 5. Is anything listening for media on UDP 10000?
sudo ss -ulnp | grep 10000

Installed with the Debian packages instead of Docker? Read the service logs with:

Terminal
sudo journalctl -u prosody -u jicofo -u jitsi-videobridge2 --since "1 hour ago"

Remove passwords, secrets and tokens before you share any output.

Send the output to an engineer

Frequently asked questions

Why does the background option work on web but not in my Jitsi mobile SDK?

Web and native clients use different effect implementations. In the October 2026 SDK feature request, a maintainer explained that native effects need their own implementation. Verify the exact SDK and host application's supported features instead of copying a web flag.

Is there a release date for native SDK virtual backgrounds?

The maintainer response reviewed on 24 October 2026 gave no estimate. This guide does not establish a future delivery date or claim that every third-party app has the same capabilities.

Can a server disable web backgrounds?

The reviewed web helper checks whether config.virtualBackground.disabled is true. That is one web configuration gate, not a complete device-support test or a portable native implementation.

Does a missing blur control mean the camera is broken?

No. Test ordinary camera video separately from an effect. A working camera, a visible background selector and an effect that renders correctly are different checks.

What details help investigate a background failure?

Record server/client versions, browser versus native app or SDK, device/OS, whether ordinary video works, and whether the control is missing or processing fails after selection. Use a disposable meeting and keep private images and invitation links out of public reports.

Discussion

    Stuck, or would rather not do this by hand?

    Deploy it in one click

    A private Jitsi server in your own AWS account with SSL, your domain and optional recording, transcription and JWT. Free 15 minute trial.

    Start free trial

    Talk to a Jitsi engineer

    Setup, fixes, branding, recording, scaling. Tell us what is happening and we reply with a plan and a quote.

    Get expert help

    Related

    Recently updated