Web Bluetooth (GATT)
Lets a site connect to a nearby Bluetooth LE device the person picks.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Partial | 70 | 2018-10-16 | Linux support is not enabled by default. |
| Edge | Partial | 79 | 2020-01-15 | Linux support is not enabled by default. |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 56 | 2017-02-01 | None |
| Samsung Internet | Supported | 6.0 | 2017-08-23 | None |
How a site asks for it
| API | navigator.bluetooth.requestDevice({filters|acceptAllDevices, optionalServices}), device.gatt.connect(), getPrimaryService(), characteristic.readValue()/writeValue()/startNotifications() |
| Permission name | bluetooth |
| Permissions policy | bluetooth |
| Browser compat keys | api.Bluetoothapi.BluetoothDeviceapi.BluetoothRemoteGATTCharacteristic |
| How access is granted | picker |
| What the user sees | Chooser showing nearby BLE devices that match filters, with Pair button |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Per session by default; per device with getDevices() behind a flag or recent Chrome |
| How to take it back | Site settings, device.forget(), disconnect |
| Inside an iframe | Needs allow="bluetooth" |
Typical flow
- Click
- requestDevice() with service UUID filter
- gatt.connect()
- 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
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
device.name / id | string | None | device defined | id is per origin |
service UUID | string | None | 16, 32 or 128 bit | Not listed |
characteristic.value | binary | bytes | max 512 bytes per attribute | Not listed |
rssi (in advertisements) | integer | dBm | about -100 to 0 | only via scanning or watchAdvertisements |
txPower | integer | dBm | -127 to 127 | advertisement |
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
| Type | Example | Apps |
|---|---|---|
| fitness | A web page reads your heart rate band during a workout. | Polar, Wahoo |
| smart-home | A web page sets up a smart bulb or sensor over Bluetooth. | None named |
| games | A browser game uses a Bluetooth controller or a toy robot. | micro:bit |
| education | A coding class controls a micro:bit board from the browser. | micro:bit, LEGO |
| health | A glucose or blood pressure monitor sends readings to a web dashboard. | None named |
| security | A 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
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 3 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough 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
Related capabilities
Related
- 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.