Skip to Content
Platform.Ontology

Web Bluetooth (GATT)

Lets a site connect to a nearby Bluetooth LE device the person picks.

Asks you firstHardware and accessoriesBluetoothWeb browsersWhile you use it

In one line

Can connect to one nearby Bluetooth device you pick from a list

Lets a site connect to a nearby Bluetooth LE device the person picks.

Reads sensors (heart rate, battery, thermometers) and controls BLE gadgets. Reveals device names and service data; used for fitness, IoT setup and beacons.

What it can and can't do

What the user does: You tap Connect device and choose a gadget in the list, then press Pair.

It can

  • Show nearby Bluetooth LE devices that match what the site looks for
  • Connect to the one you pick
  • Get data from and send commands to that device, such as a heart monitor

It cannot

  • See devices you did not pick or other devices nearby
  • Connect without you picking from the list
  • Work in Firefox, Safari, or on iPhone
  • Work with old Bluetooth devices, since it uses only Bluetooth LE

How it differs between platforms: Chrome and Edge support it, with some limits. Safari and iPhone do not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromePartial702018-10-16Linux support is not enabled by default.
EdgePartial792020-01-15Linux support is not enabled by default.
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported562017-02-01None
Samsung InternetSupported6.02017-08-23None

How a site asks for it

APInavigator.bluetooth.requestDevice({filters|acceptAllDevices, optionalServices}), device.gatt.connect(), getPrimaryService(), characteristic.readValue()/writeValue()/startNotifications()
Permission namebluetooth
Permissions policybluetooth
Browser compat keysapi.Bluetooth
api.BluetoothDevice
api.BluetoothRemoteGATTCharacteristic
How access is grantedpicker
What the user seesChooser showing nearby BLE devices that match filters, with Pair button
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer session by default; per device with getDevices() behind a flag or recent Chrome
How to take it backSite settings, device.forget(), disconnect
Inside an iframeNeeds allow="bluetooth"

Typical flow

  1. Click
  2. requestDevice() with service UUID filter
  3. gatt.connect()
  4. Read, write or subscribe to characteristics

Data you get

What comes back: GATT services and characteristic values
Shape: object
How often: on demand and notifications

FieldTypeUnitRangePrecision
device.name / idstringNonedevice definedid is per origin
service UUIDstringNone16, 32 or 128 bitNot listed
characteristic.valuebinarybytesmax 512 bytes per attributeNot listed
rssi (in advertisements)integerdBmabout -100 to 0only via scanning or watchAdvertisements
txPowerintegerdBm-127 to 127advertisement

Technical limits

  • Cannot scan silently: requestLEScan is behind a flag and not shipped
  • Block list excludes security sensitive GATT services and characteristics
  • Only filtered device types unless acceptAllDevices
  • No Firefox, no Safari, no iOS browsers
  • Needs HTTPS and a user gesture

The story

What it is

A site asks to connect to a nearby Bluetooth gadget that you choose.

For you

A picker shows nearby devices. You choose one, and the page can talk to just that one, like a heart rate band or a fitness gadget.

For makers

Makers can set up and control gadgets from a web page, with no app to install. The page only sees the one device you pick.

Where you see it

TypeExampleApps
fitnessA web page reads your heart rate band during a workout.Polar, Wahoo
smart-homeA web page sets up a smart bulb or sensor over Bluetooth.None named
gamesA browser game uses a Bluetooth controller or a toy robot.micro:bit
educationA coding class controls a micro:bit board from the browser.micro:bit, LEGO
healthA glucose or blood pressure monitor sends readings to a web dashboard.None named
securityA bad site could tempt you to pick a device and then read its data.None named

Risks

  • Picking the wrong device
  • Tracking by device id

What the platform says

  • Google: Web Bluetooth. Chrome's docs say the API lets a page talk to nearby Bluetooth Low Energy devices, with a picker.

Good uses and abuse

Legitimate uses

  • Fitness sensors
  • IoT onboarding
  • Retail BLE beacons

Known abuse

  • Proximity detection
  • Sensor reads leaking health data

Scores

ScoreValueMeaning
Sensitivity3 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2017-02, Chrome 56: Web Bluetooth ships on Chrome Android
  • 2017-09, Chrome 70: Desktop Chrome on Windows, macOS, Linux, ChromeOS
  • 2019, Chrome 78: getAvailability()
  • 2020, Chrome 85: getDevices() and watchAdvertisements behind flag; still experimental in 2026
  • Web Serial. Can open one serial port you pick and exchange data with it
  • WebUSB. Can talk to one USB device you pick from a list

Sources

How well checked: Checked against real behavior.

On this page