# Pair and manage WMS worker devices
URL: https://support.starshipit.com/articles/14700000000082-pair-and-manage-wms-worker-devices
Canonical: https://support.starshipit.com/articles/14700000000082-pair-and-manage-wms-worker-devices
Markdown: https://support.starshipit.com/articles/14700000000082-pair-and-manage-wms-worker-devices.md
Updated: 2026-11-08

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Pair a handheld device to a WMS worker, switch workers and remove or revoke a device pairing.

Pairing lets WMS workers use the mobile app without their own Starshipit accounts. It links one installation of WMS Mobile to one WMS account and signs in the worker selected by the administrator.

## Before you pair

Make sure:

* A WMS administrator has [created an active WMS worker and assigned the correct role](/articles/14700000000036-set-up-wms-users-roles-and-client-access).
* The administrator has the **Admin** role, or the `staff.manage` permission and access to all clients.
* The mobile device has internet access and permission to use its camera.
* A fresh installation is signed in through **Sign in with Starshipit**. The pairing setting is only available while a Starshipit user is signed in.

The pairing QR code is single-use and expires after two minutes. Generate it only when the mobile device is ready to scan it.

## Generate and scan the pairing code

1. In desktop WMS, go to **System > Roles & Permissions**.
2. If the worker is not listed, select **Add local worker**. Enter their username, display name and password, choose their role and interface policy, then select **Save worker**.
3. On the **Users** tab, find the active WMS-local worker who will use the device. Use the search box if needed. WMS-local workers have a **Local** label below their display name.
4. At the far right of the worker's row, select the ellipsis (**...**) button to open the **Actions** menu, then select **Pair device**.

![The WMS Roles and Permissions page showing the ellipsis Actions menu and Pair device option for an active local worker](/uploads/articles/starshipit-wms/web/warehouse-configuration/pair-wms-worker-device.jpg)

5. In the **Pair <worker name>** dialog, find the expiry time in the text above the one-time QR code. Keep this dialog open while the mobile device scans the code.
6. On the mobile device, go to **More > Settings > WMS worker pairing**.
7. Tap **Open camera scanner** and allow camera access if prompted.
8. Scan the QR code before it expires.

WMS Mobile displays **Device paired**, signs in the selected worker, and opens **Jobs**.

:::important
The QR code signs the selected worker into the device. Do not save or share the code before it is scanned.
:::

## Verify the pairing

1. In WMS Mobile, go to **More > Settings > Connected Account**.
2. Confirm the worker name, username, and WMS account are correct.
3. Sign out when you have finished checking.
4. From **Connect to WMS**, tap **Sign in as WMS worker**. Confirm the paired account and device appear on the worker sign-in screen.

## Switch to another WMS worker

Another active worker from the same WMS account can use the paired device without repeating the initial Starshipit sign-in:

1. Go to **More > Settings > Connected Account**.
2. Tap **Switch WMS worker**, then confirm **Switch Worker**.
3. Enter the next worker's WMS username and password, or tap **Scan WMS worker QR** and scan a new code generated for that worker.

The device stays paired to the same WMS account when workers switch.

## Remove or revoke a pairing

Remove a pairing when the device changes warehouse, changes WMS account, or should no longer allow worker sign-in.

To remove it from the mobile device:

1. Sign out of the WMS worker session.
2. Sign in through **Sign in with Starshipit**.
3. Go to **More > Settings > WMS worker pairing**.
4. Tap **Remove pairing**, then confirm **Remove**.

An administrator can also go to **System > Roles & Permissions**, find the device under **Paired devices**, and select **Revoke**. Removing or revoking the pairing ends its WMS worker sessions. The device must be paired again before another WMS worker can sign in.

## Troubleshoot pairing

| Problem | What to do |
|---|---|
| **WMS worker pairing** is not visible in mobile Settings | Sign out, then use **Sign in with Starshipit**. A WMS worker session cannot manage the device pairing. |
| The QR code is invalid, expired, or already used | Close the code in desktop WMS, generate a new one, and scan it within two minutes. |
| The device is already paired to another WMS account | Remove the existing pairing from the device or revoke it from the original WMS account, then pair it to the new account. |
| **Pair device** is missing for the worker | Confirm the worker is a WMS-local worker and is active. Also confirm the administrator can manage roles and has access to all clients. |
| The camera does not open or scan | Allow camera access in the device settings, confirm the device is online, and increase the brightness of the screen showing the QR code. |
| Worker sign-in is temporarily locked after repeated failures | Wait 15 minutes before trying again, or ask an administrator to check the worker's username, status, access expiry, and password. |

## Related articles

* [Set up WMS Mobile](/articles/14700000000023-set-up-wms-mobile)
* [Set up WMS users, roles and client access](/articles/14700000000036-set-up-wms-users-roles-and-client-access)
* [Troubleshoot Starshipit WMS Mobile](/articles/14700000000038-troubleshoot-starshipit-wms-mobile)