◆Error Codes Wiki

Web Bluetooth Device Not Found — Browser Bluetooth Connection and Pairing Errors

Informationalgeneral

Overview

Fix Web Bluetooth API errors when the browser cannot discover, pair with, or communicate with Bluetooth Low Energy (BLE) devices.

Key Details

  • The Web Bluetooth API allows websites to communicate with Bluetooth Low Energy (BLE) devices
  • It requires HTTPS, user gesture (button click), and explicit user permission via a device chooser
  • Only Chromium-based browsers (Chrome, Edge, Opera) currently support Web Bluetooth
  • Firefox and Safari do not support Web Bluetooth due to security and privacy concerns
  • The API only supports Bluetooth Low Energy (BLE), not classic Bluetooth

Common Causes

  • Bluetooth disabled on the computer or not available on the device
  • The Bluetooth device is not in pairing/discovery mode
  • Browser does not support Web Bluetooth (Firefox, Safari)
  • The website's filter criteria in requestDevice() do not match the Bluetooth device's advertised services

Steps

  1. 1Ensure Bluetooth is enabled on the computer: check system Bluetooth settings
  2. 2Put the BLE device into pairing/advertising mode before clicking the scan button on the website
  3. 3Use the correct service UUID filters in navigator.bluetooth.requestDevice() to match the device
  4. 4Try Chrome (or Edge) as it has the best Web Bluetooth support — Firefox and Safari do not support it
  5. 5Test with chrome://bluetooth-internals/ to see all nearby BLE devices and their services

Tags

web-bluetoothblepairingdeviceapi

More in General

printer-offlinePrinter Offline Error
Warning
driver-unavailablePrinter Driver Is Unavailable
Warning
spooler-errorPrint Spooler Error
Warning
pcl-xl-errorPCL XL Error — Subsystem Kernel
Warning
printer-duplex-printing-errorsPrinter Duplex (Double-Sided) Printing Errors — Jams, Alignment & Blank Pages
Warning
printer-usb-connection-errorsUSB Printer Errors — Not Detected, Driver Issues, and Connection Troubleshooting
Warning

Frequently Asked Questions

Chrome (desktop and Android), Edge, and Opera support Web Bluetooth. Firefox and Safari do not, citing security and privacy concerns. Chrome iOS also does not support it due to WebKit engine limitations.