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

# Manage floor terminals and employee PIN access

> Monitor terminal health, edit assignments, control access, review history, and recover employee PIN access.

Organization administrators manage paired production devices and personal
floor PINs from the full Flexoworks application. Terminal controls affect the
device connection or its current worker; employee floor-access controls affect
one person's PIN. These are separate from normal full-application login.

<Note>
  The controls in this guide require the **Org admin** role. Open
  **Organization → Floor terminals** to manage devices and **Organization →
  Users** to manage employee PINs.
</Note>

If no device has been paired yet, start with
[Set up a new floor terminal](/guides/floor-terminal-setup).

## Understand the terminal list

Each terminal card shows:

* its name and CDI imaging work area;
* lifecycle status and current connectivity;
* location and optional default equipment;
* current worker, or **Locked** when no worker is signed in;
* last-seen and paired times;
* the administrator who approved it.

<Frame caption="The Floor terminals tab separates device status, connectivity, assignment, and current worker.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/terminal-list.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=906bbd9d80bd81bbf60029004e0c74e0" alt="Floor terminal administration list with status badges, connectivity, location, equipment, and current worker" width="1440" height="900" data-path="images/floor-terminal-management/terminal-list.png" />
</Frame>

The lifecycle statuses mean:

| Status                 | Meaning                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------- |
| **Pending activation** | An administrator approved pairing, but the production browser has not completed activation. |
| **Active**             | The terminal is paired and may accept a worker PIN.                                         |
| **Suspended**          | An administrator temporarily paused the terminal. Its pairing is retained.                  |
| **Revoked**            | The enrollment is permanently invalid and the device must be paired again.                  |

**Online** and **Offline** are separate from lifecycle status. Online means the
recorded last check-in was during approximately the previous two minutes.
Offline does not by itself mean that pairing was lost. The list refreshes in
the background about every 30 seconds.

Revoked terminals are hidden initially. Select **Show revoked** when you need
to review them or open their history.

## Edit terminal configuration

Select **Edit** to change:

* the terminal name;
* its location;
* its optional default equipment.

The current work area is **CDI imaging** and is read-only. Names can contain up
to 80 characters and must be unique among non-revoked terminals.

<Frame caption="Edit the name, location, and optional default equipment without re-pairing the device.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/edit-terminal.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=13f432dd0f6c05114524966e28d08e4e" alt="Edit floor terminal dialog with name, read-only CDI work area, location, and default equipment" width="1440" height="900" data-path="images/floor-terminal-management/edit-terminal.png" />
</Frame>

Changing only the name or default equipment keeps the current worker. Changing
the location locks the current worker and clears default equipment that is not
available at the new location. The terminal reconnects using the new
assignment. Operators can always choose any equipment configured at that
location, even when a default is selected.

## Review terminal history

Select **History** to open the terminal's append-only activity history. Events
are shown newest first, 20 at a time. Select **Load more** for older entries.

<Frame caption="Terminal history records device, worker, and production actions with actor and time.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/terminal-history.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=3d7b4f06e3413168fc676e6fe7fea8dc" alt="Terminal history dialog with pairing, worker login, production completion, and administrative events" width="1440" height="900" data-path="images/floor-terminal-management/terminal-history.png" />
</Frame>

The terminal history can include:

* pairing and activation;
* setting changes;
* remote worker locks;
* suspension, resume, and revocation;
* worker login and worker lock;
* production-line completion and undo;
* production problem reports;
* terminal or organization PIN-entry lockouts.

Production events include the related job number when available. Employee PIN
enable, reset, and disable actions are organization-level audit events and
should not be expected in one specific terminal's history.

## Lock the current worker

Select **Lock worker** when a worker left the terminal unlocked or when a shift
changes. Confirm the action.

<Frame caption="Remote lock ends only the current worker session.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/lock-worker-confirm.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=65cd8e838f492b44cb21c563e9515f59" alt="Confirmation dialog for remotely locking the worker on a floor terminal" width="1440" height="900" data-path="images/floor-terminal-management/lock-worker-confirm.png" />
</Frame>

Locking:

* clears the current worker session;
* leaves the terminal active and paired;
* returns the device to PIN entry on its next check-in;
* does not disable the employee's PIN on other terminals.

The action appears only while an active terminal has a current worker.

## Suspend and resume a terminal

Use **Suspend** for a temporary device pause, such as maintenance or a security
review. Confirm the action before it is applied.

<Frame caption="Suspension is temporary and explicitly keeps the terminal paired.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/suspend-confirm.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=60207bd7406b5b180d5721952f391a95" alt="Confirmation dialog explaining that a suspended terminal remains paired" width="1440" height="900" data-path="images/floor-terminal-management/suspend-confirm.png" />
</Frame>

Suspension clears the worker and short terminal session, but preserves the
durable pairing. The production device shows that an organization
administrator paused it.

<Frame caption="A suspended device waits for an administrator to resume it.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/suspended-terminal.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=a845399fce9fbc02b278647d99f4e621" alt="Physical floor terminal showing the Terminal suspended state" width="1440" height="900" data-path="images/floor-terminal-management/suspended-terminal.png" />
</Frame>

Select **Resume** on the terminal card when it may be used again. A connected
device checks automatically and returns to its PIN screen without a new QR
code. Suspension and resume are both retained in terminal history.

## Revoke a terminal

Revocation permanently invalidates the browser's current terminal enrollment.
Use it when a device is retired, lost, replaced, reimaged, or no longer
trusted. It is not the same as temporary suspension.

Select **Show revoked** to include earlier revoked devices in the list.

<Frame caption="The Show revoked option keeps decommissioned terminals available for audit.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/show-revoked.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=4745054822ed1aa064ded4adde03fdce" alt="Floor terminal list with Show revoked selected and a revoked terminal visible" width="1440" height="900" data-path="images/floor-terminal-management/show-revoked.png" />
</Frame>

Select **Revoke** and confirm the destructive action.

<Frame caption="Revocation warns that the physical device must be paired again.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/revoke-confirm.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=5bf057ba527dc8129ed6f592abde177c" alt="Confirmation dialog warning that revoking a terminal requires new pairing" width="1440" height="900" data-path="images/floor-terminal-management/revoke-confirm.png" />
</Frame>

Revocation:

* clears the current worker;
* invalidates the terminal session and enrollment;
* cannot be resumed;
* keeps the terminal and history available under **Show revoked**.

The physical device displays **Terminal access revoked**. Select **Reset and
pair again** on that device only when it should be enrolled as a new terminal.

<Frame caption="A revoked device must be reset and paired again before production use.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/revoked-terminal.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=20b275777b220446436734f5711ea261" alt="Revoked floor terminal screen with the Reset and pair again action" width="1440" height="900" data-path="images/floor-terminal-management/revoked-terminal.png" />
</Frame>

## Manage employee floor PINs

Open **Organization → Users**, open a team member's action menu, and select
**Manage floor access**. The dialog shows:

* whether floor access is enabled;
* when it was last used;
* the last terminal used;
* any current user-level temporary lock.

An active team member with enabled floor access can use any paired terminal in
the organization. Terminal PIN access is not limited by the employee's role,
function, or assigned location.

From this dialog, an administrator can:

* **Enable floor access** by entering and confirming a unique four-digit PIN.
* **Reset PIN** by replacing it with another unique four-digit PIN.
* **Disable floor access** while leaving normal full-app login unchanged.
* **Unlock** a user-level temporary PIN lock without changing the PIN.

Flexoworks never displays an existing PIN. Resetting or disabling one
immediately ends that employee's active floor sessions on every terminal.

<Frame caption="A temporarily locked employee PIN can be unlocked without changing full-app access.">
  <img src="https://mintcdn.com/flexoworks/pXK9IAjYBe1kaAVA/images/floor-terminal-management/floor-pin-locked.png?fit=max&auto=format&n=pXK9IAjYBe1kaAVA&q=85&s=e7622884a561cc60e2edcfbd6d05cb33" alt="Manage floor access dialog showing a temporarily locked PIN, lock-until time, and Unlock action" width="1440" height="900" data-path="images/floor-terminal-management/floor-pin-locked.png" />
</Frame>

<Warning>
  **Unlock** clears only the selected employee's user-level PIN lock. If a
  terminal keypad shows a general **Too many attempts** countdown, wait for the
  displayed time before trying again. Terminal-wide and organization-wide
  protections expire automatically and are not cleared by the employee Unlock
  action.
</Warning>

Disabling floor access is narrower than suspending a user. Disabling the PIN
blocks only floor-terminal login. Suspending the user from the Users tab blocks
both floor access and normal Flexoworks authentication, including existing
full-app sessions.

## Keep a production device paired

For a durable installation:

* use a managed, persistent browser profile;
* allow cookies and site data for the Flexoworks app address;
* do not clear browsing data when the browser closes;
* always use the same Flexoworks hostname;
* let the device reconnect after power or network outages before changing its
  administration state.

Ordinary short-session expiry, application updates, browser restarts, device
restarts, and recoverable network errors do not require re-pairing.

## Related guides

* [Set up a new floor terminal](/guides/floor-terminal-setup)
* [Floor terminal overview](/guides/floor-terminal-overview)
