# Bluetooth Unlock

{% hint style="success" %}
Bluetooth unlock is currently only compatible with Verkada readers.
{% endhint %}

## Command Configuration

Before a user can unlock a door with Bluetooth unlock Bluetooth permissions need to be enabled on the following levels:

* [Organization level](#h_84ce0a0fc6)
* [Site level](#h_6d2a419a6a)
* [Door level](#h_e8e7d247d5)
* [User level](#h_1095df58db)

### Organization level configuration

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** > **Access** .

{% endstep %}

{% step %}

#### On the left navigation, click **Access** **Settings**.

{% endstep %}

{% step %}

#### Toggle on **Enable Bluetooth Door Unlock.**

{% endstep %}

{% step %}

#### (Optional)To have Bluetooth credentials granted by default to all new users, toggle on **Auto-Enable Bluetooth for new users.**

{% endstep %}
{% endstepper %}

### **Site level configuration**

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** > **Access** .

{% endstep %}

{% step %}

#### From the **All Sites** dropdown, select a site.

{% endstep %}

{% step %}

#### At the top, click **Access** **Settings**.

{% endstep %}

{% step %}

#### Toggle on **Enable Bluetooth Door Unlock.**

{% endstep %}
{% endstepper %}

### **Door level configuration**

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** >**Access** .

{% endstep %}

{% step %}

#### From the **All Sites** dropdown, select a site.

{% endstep %}

{% step %}

#### Select a door and click **Settings**.

{% endstep %}

{% step %}

#### Under **Verkada Pass,** toggle on **Bluetooth Unlock.**

{% endstep %}

{% step %}

#### (Optional) You can configure these Bluetooth settings:

a. **Unlock Proximity**

* Immediate: phone needs to touch the reader (-35 RSSI)
* Near: Phone needs to be around 2 to 3 ft from the reader (-45 RSSI)
* Far: Phone needs to be around 7 to 8 ft from the reader (-60 RSSI)
* Custom: set your own RSSI value

f. **Bluetooth Cooldown** is the delay between subsequent Bluetooth unlock attempts from the same phone.\
g. **Beep on Bluetooth Unlock** will have the Verkada reader beep each time a Bluetooth unlock is attempted.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The distance a phone will unlock a door via Bluetooth depends on multiple factors including the material the reader is mounted on. This can result in varying unlock distances with the same configuration. Hold the phone at the distance you would like to unlock the door and adjust the settings until the unlock succeeds.
{% endhint %}

### User level configuration

**Individual user configuration**

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** > **Access** .

{% endstep %}

{% step %}

#### On the left navigation, click **Access Users and Groups** .

{% endstep %}

{% step %}

#### Select a user and click **Profile.**

{% endstep %}

{% step %}

#### Under **Verkada Pas**s toggle on **Bluetooth Unlock**.

{% endstep %}
{% endstepper %}

**Bulk user configuration**

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** >**Access** .

{% endstep %}

{% step %}

#### On the left navigation, click **Access Users and Groups** .

{% endstep %}

{% step %}

#### Select the checkbox next to each user that you want to grant Bluetooth unlock permissions.

{% endstep %}

{% step %}

#### In the top right, click **Enable Bluetooth Unlock** .

{% endstep %}

{% step %}

#### When prompted, click **Confirm.**

{% endstep %}
{% endstepper %}

{% hint style="warning" %}
An email address is required to enable Bluetooth unlock. If you select a user without an email the bulk enable option will be disabled until the non-email user(s) are deselected.
{% endhint %}

## Verkada Pass Invites

Verkada Pass & Verkada readers are required for Bluetooth unlock. Users must have location sharing "always on" (iOS) and "when in use" (Android) enabled on their respective devices. Bluetooth permissions must be enabled on the user’s profile and Bluetooth enabled on the door they are trying to unlock.

### Individual Pass app invite

A user is sent an email invite to Verkada Pass when at least one of the following is true:

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** > **Access** .

{% endstep %}

{% step %}

#### On the left navigation, click **Access Users and Groups** .

{% endstep %}

{% step %}

#### Select a user and click **Profile.**

{% endstep %}

{% step %}

#### Under **Verkada Pas**s next to **Verkada Pass Invite** click **Send Invite.**

{% endstep %}
{% endstepper %}

### Bulk Pass app invite

Multiple users can be invited simultaneously via the Access Users tab

{% stepper %}
{% step %}

#### In Verkada Command, go to **All Products** > **Access** .

{% endstep %}

{% step %}

#### On the left navigation, click **Access Users and Groups** .

{% endstep %}

{% step %}

#### Select the checkbox next to each user that you want to grant Pass app permissions.

{% endstep %}

{% step %}

#### In the top right, click **Send Pass Invite** .

{% endstep %}

{% step %}

#### When prompted, click **Yes.**

{% endstep %}
{% endstepper %}

## Bluetooth OS Permissions

### iOS

* Verkada Pass app needs to be running in the background (in your app switcher, does not need to be in the foreground)
* Location services need to be "always"
* Bluetooth permissions need to be on
* Bluetooth needs to be on

  ![](https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2Fgit-blob-1d59a56e9440e060d7c2c4e73f7241e607817885%2F555e6a07b18c007a6aef6383eefe108e3e259875.png?alt=media)

### Android Permissions

* Verkada Pass app notification should be in the notification center (this allows Verkada Pass Bluetooth to work when the app is closed)
* Location services need to be "Only while app is in use"
* Bluetooth needs to be on

  ![](https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2Fgit-blob-079abdd5eaa82505216d62f2509d0bf4ec3c9723%2Fbdab65570d67626149ef86912b2db20af8943dba.png?alt=media)

### Troubleshooting

If you are experiencing issues with Bluetooth unlock, try the following:

* Verify that organization, site, door, and user settings all have Bluetooth unlock enabled.
* iOS:
  * Verify that Verkada Pass has location set to "always on" and Bluetooth is on.
  * Toggle the Bluetooth permission in the Settings app for the Verkada Pass app.
* Android
  * Android users may need to reboot their phone after the installation to get the Bluetooth unlock feature initialized.
  * Android Bluetooth is a bit slower than iOS Bluetooth, so users may need to place their phone closer to the reader and keep it there for a few seconds.
  * Disable NFC on that door if you are not using HF cards.
* Getting keycard denied events when trying to unlock the door with Bluetooth?
  * The phone’s NFC chip is being scanned by the HF antenna on the Verkada Reader. This is probably caused by Apply Pay or Google Pay.
    * Are you exclusively using low-frequency cards? If so, disable NFC Antenna to resolve this issue:

      ![](https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2Fgit-blob-5721e591fa112ed8df34d3e2aa7f955841e63583%2F442641c20bdbc700d103108a69de76ca9562acc7.png?alt=media)
    * If you are using high-frequency cards (Mifare or Desfire), it is recommended that you increase the Unlock Proximity to Near (or set a custom Bluetooth Unlock RSSI value that is less than -35 such as -40 or lower):

      ![](https://134288481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaaHs5RfKqv9Z49mi02cC%2Fuploads%2Fgit-blob-ae930c26a96c7193e97bf75e65fcd294f21b7313%2Faac88d5bb2ad3840fd63fc95d8526c2693257ca4.png?alt=media)

&#x20;

* Still not working?
  * Uninstall/reinstall the Verkada Pass app.
  * Reboot your mobile device.
  * Toggle Bluetooth permissions off and on again.
* [Contact Verkada Technical Support](https://app.gitbook.com/s/NRq5qDDjsYNxwNzF1bcB/need-help/contact-verkada-support) if you are still experiencing issues.

{% hint style="warning" %}
Doors will not log Bluetooth unlock events while the door shows as open.
{% endhint %}

***

{% hint style="info" %}
**Prefer to see it in action?** Check out the [video tutorial](https://www.youtube.com/watch?v=8r7YcbrnGZY).
{% endhint %}

{% hint style="success" %}
**Need more help?** Contact [Verkada Support](https://app.gitbook.com/s/NRq5qDDjsYNxwNzF1bcB/need-help/contact-verkada-support).
{% endhint %}
