> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Badge

> The employee taps their badge or smart card on a reader attached to the device, and TruU compares its identifier with your directory. For shared workstations with readers.

Badge asks the employee to tap their badge or smart card on a reader attached to the device. The reader passes the badge identifier to the verification page, and TruU compares it with the value in your directory. It suits shared workstations that already have readers. It isn't available on phones.

## Before you start

* Badge readers attached to the devices where employees verify, sending the badge identifier as keyboard input.
* A directory attribute that holds each employee's badge identifier, in the same format the readers send.

## Settings

Open **Factors → Badge**.

| Setting | What it does | Default |
| - | - | - |
| **Badge identifier attributes** | Directory attributes tried in order; the first with a value for the employee is compared with the badge | None until you add one |
| **Attempts per run** | Failed taps allowed before the factor fails | 2 tries |

> [!WARNING]
>
> Badges can be borrowed, and badge numbers are often printed on the card. Never use Badge alone in a column; pair it with a one-time code at minimum.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| Every tap fails | The reader sends a different format than the directory stores (decimal vs hex, facility code prefix) | Compare a raw reader output with the directory value and store the reader's format |
| Badge isn't offered | No badge identifier attribute is set, or it's empty for the employee | Add the attribute and check coverage |

## Related

* [Shared devices](https://docs.truu.ai/idv/use-cases/shared-devices.md)
* [How factors work](https://docs.truu.ai/idv/factors/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.