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

# Manage your lockboxes

> View status, assign to properties, retrieve one-time codes, and update settings.

The [Lockboxes page](https://app.rentsmart.com/lockboxes) is your home base for every Codebox on your account. Filter by status, generate one-time codes, edit settings, and assign units to properties.

## Page layout

* **Status filter pills** across the top — All, Connected, Unassigned, Shipped, Processing, and (when active) Removal and Return
* **Buy / Link Lockbox** button in the top-right
* One **Lockbox Card** per unit below

## Lockbox card anatomy

Every card has three parts:

**Header:**

* Serial number (or placeholder text like "Processing Codebox" or "Shipped")
* Status pill with a color: Connected (green), Processing (yellow), Shipped (blue), Unassigned (red), Removal/Return (grey)

**Body:**

* **Door Code** and **Shackle Code**
* The property the codebox is attached to (if Connected) or was previously attached to (if Unassigned)

**Footer (varies by status):**

* **Connected / Unassigned** — **One-Time Code** and **Settings** buttons
* **Shipped** — **Track Shipment** and **Activate** buttons (Track Shipment becomes available once tracking info is in)
* **Processing / Removal / Return** — no actions (waiting on RentSmart to advance the state)

## Generate a one-time code

Available on **Connected** and **Unassigned** lockboxes. Click **One-Time Code** on the card.

In the modal:

* **Access Date** — the date the code is valid (valid only on this date)
* **Send code via SMS** (optional) — adds Recipient Name and Phone Number fields; if checked, the code is texted automatically

Click **Generate Code**. The code is shown on screen and (optionally) texted to the recipient.

<Note>
  One-time codes work for **a single access on the specified date only**. They're not reusable on other days or by other people.
</Note>

## Lockbox settings

Click **Settings** on a Connected or Unassigned card. The modal lets you update:

* **Door Code**
* **Shackle Code**
* **Admin Code** (defaults to `000691` if left blank)

<Warning>
  After updating codes here, you **must also manually update the physical lockbox device** to match. The codes don't sync automatically to the hardware — you have to enter them on the device too.
</Warning>

Save Changes commits; Cancel discards.

## Assigning a lockbox to a property

Two paths:

* **At property activation** — when you [activate a property](/properties/activate-listing) as Self-Access, the Assign a Lockbox dropdown lets you pick any Unassigned lockbox
* **Swap on an active property** — open the property → Showing Coordinator widget → click the lockbox display at the top → pick a different Unassigned lockbox

A swap takes effect immediately. The previously-assigned lockbox returns to **Unassigned** status.

## Activating a shipped Codebox

When a purchased Codebox arrives, click **Activate** on its card. Enter the **serial number** from the physical unit, click **Activate Lockbox**, and the codebox transitions to **Unassigned**.

## Requesting removal

The **Request Removal** button (inside the Settings modal) lets you send a Codebox back to RentSmart.

<Warning>
  **Request Removal is only available when the Codebox is Unassigned.** If it's Connected to a property, you have to swap it off first.
</Warning>

You'll see a confirmation:

> Your request will be processed within 1 business day.

The Codebox transitions to **Removal** status, then to **Return** while it physically ships back, then disappears from your page.

<CardGroup cols={2}>
  <Card title="Lockbox statuses" icon="list-check" href="/reference/lockbox-statuses">
    Full reference for every status and what it allows.
  </Card>

  <Card title="Self-Access showings" icon="key" href="/showings/self-access">
    How leads use lockboxes to tour properties.
  </Card>
</CardGroup>
