# Smart Locks

The **Smart Locks** page is your hub for monitoring and managing every connected smart lock across your portfolio — connection status, access codes, activity history, and the rules that govern when guests get in or out.

***

### The Smart Locks list

The Smart Locks list shows every smart lock currently linked to your account. Each lock displays:

* A default **icon**.
* The lock's **unique identity code**.
* The **listing** it's installed in.
* The lock's **specific location** within the property.
* **Connection status** — online or offline.
* **Battery** — charge level and whether the device is currently charging.

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/zklml18for>" %}

At the top of the page:

* **Refresh** updates the list with the latest data.
* The **Grid / Table** view toggle switches between a card-style grid and a denser table layout.

***

### Lock Details and Configuration

The left side of the lock detail view summarises the device's status, settings, and links into your property management system.

#### Lock Header

The **Lock Header** displays the lock's custom **name** alongside its **brand**, with a status label confirming whether the lock is online. You can rename the device or edit its description from here.

#### Device Components

The **Device Components** section shows whether the lock's peripherals are active and connected:

* **Keypad** — whether the external keypad is properly linked and operational.
* **Door sensor** — whether the sensor is online and detecting open / closed states.

#### Actions

The **Actions** area carries an **Open Door** control that lets authorised users remotely unlock the door from Guestway, without being on-site.

#### Location

The **Location** section labels the entry point the lock controls — for example *Apartment door*, *Building entrance*, or *Storage room*.

#### Guest Access Settings

These toggles define how and when guests can interact with the smart lock:

* **Guest Can Open Remotely** — guests can unlock the door from their phone via the [Guest Portal](https://docs.guestway.io/guestway-platform/guest-portal).
* **Prevent Access Until Checked-in** — guests can't use their access code until their official check-in time begins.
* **Revoke Access on Check-out** — guest access is automatically disabled the moment the stay ends.

#### Check-in and check-out offsets

Fine-tune *exactly* when guest access activates and expires:

* **Check-in offset** — number of minutes **before** check-in time when guest access becomes available (e.g. give guests 30 minutes' grace if they arrive early).
* **Check-out offset** — number of minutes **after** check-out time when guest access remains valid (e.g. allow 15 minutes after check-out for the guest to grab a forgotten item).

These offsets work alongside the **Prevent Access Until Checked-in** and **Revoke Access on Check-out** toggles.

#### Device Health

The **Device Health** section tracks the lock's performance:

* **Uptime** — shown as a percentage and a visual 30-day timeline.
* **Battery** — a 30-day graph helps you anticipate when the device will need a fresh battery.

#### Linkage

The **Linkage** section shows which **listings** the lock is connected to, and whether it's also part of a **complex**. You can link or unlink the lock from any listing or complex directly here.

#### Subscription state

A lock can be **unsubscribed** to pause Guestway's syncing without deleting it — useful when a unit is temporarily off the market but you'll bring the lock back online later.

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/gky9ol1udp>" %}

***

### Activity Logs Panel

The **Activity Logs** panel is a real-time, chronological timeline of every interaction with the lock — physical, keypad, or remote. Each entry is time-stamped, giving full traceability and control.

Common log entry types:

* **Manually** — physical actions, such as someone unlocking or locking the door by hand, or the door being opened or closed without an access code.
* **Keypad** — interactions involving the keypad, like locking or unlocking with a specific code.
* **Access with Code** — identifies which code was used (manual code set up by an admin, or a fallback code generated automatically).
* **Motor Blocked** — signals a hardware issue when the lock mechanism encountered physical resistance during operation; useful for maintenance and troubleshooting.
* **Date and Time** — every entry carries a precise timestamp, so you always know who accessed the property and when.

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/zpez21wf3p>" %}

***

### Access Codes and Scheduling

The **Access Codes** section lists every digital code generated for the selected lock. Each row shows the code's name, type, validity, and current status.

#### Code types

A small icon next to the code name tells you how the code was created:

| Type          | What it is                                                                                                |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| **Automatic** | Generated by Guestway based on a reservation — created when a stay is confirmed and removed when it ends. |
| **Manual**    | Created by a user directly on the lock (for cleaners, maintenance, long-term access, etc.).               |
| **Fallback**  | A backup code that can be used if automatic codes fail or aren't available.                               |

#### Code validity states

Every code carries a validity status that reflects where the code is in its lifecycle:

* **Active** — the code is currently usable.
* **Upcoming** — the code is scheduled for a future window and not yet usable.
* **Expired** — the code's window has ended and the code can no longer unlock the door.

#### Duration

The **Duration** column shows how long each code is valid:

* Some codes are marked **Always** — they work at any time without restrictions.
* Others are valid for a specific window — ideal for guest stays, maintenance visits, or temporary staff.

#### Per-code actions

For each code:

* Click the **eye icon** to reveal the PIN.
* Click the **three-dot menu** to delete or disable the code.
* The **last used** timestamp shows when the code was last used to open the door — useful for retiring codes that are no longer in use.

#### Schedule Overview

Below the code list, the **Schedule Overview** summarises scheduled access tied to specific users or guests, so you can see at a glance who can enter when.

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/qp7w6jvtjk>" %}

***

### How can you create a new access code?

To create a new access code, click the **+** button. You'll be prompted to fill out three essential fields:

1. **Name** — assign a label so the code is easy to identify later (e.g. *Cleaner*, *Guest*, *Maintenance*).
2. **PIN code** — the numeric sequence the guest or user will use to unlock the door.
3. **Duration** — set a start and end date (and time, if needed) to define the active window.

Once saved, the code appears in the access list with all relevant details and status indicators.

{% @guideflow/guideflow-embed requestedUrl="<https://app.guideflow.com/player/zkjlwm7hep>" %}

***

### Tips

* **Configure offsets to match real-world arrival patterns.** A 30-minute check-in offset spares guests (and your inbox) when their flight lands a little early.
* **Keep Revoke Access on Check-out enabled by default.** It's the cleanest security policy — every stay gets a fresh code window.
* **Use Manual codes for recurring staff.** Cleaners, maintenance, and supervisors don't need a new automatic code per booking — give them named manual codes and rotate them on a schedule.
* **Watch the Battery graph.** A drop in the 30-day battery graph is your early-warning signal — change the batteries before a guest gets locked out.
* **Re-link rather than unlink-and-relink.** Moving a lock between listings keeps its history intact for activity logs and reporting.
* **Retire codes you don't use.** Old codes with **Last used** dates from months ago are a security hygiene issue — disable them.

***

### Related pages

* [Static Locks](https://docs.guestway.io/guestway-platform/static-locks) — manage manual lock codes and keyboxes that don't connect to Guestway directly.
* [Guest Portal](https://docs.guestway.io/guestway-platform/guest-portal) — where guests open the door remotely when **Guest Can Open Remotely** is enabled.
* [Unified AI Inbox](https://docs.guestway.io/guestway-platform/unified-ai-inbox) — share access codes from the **Access** tab during a guest conversation.
* [General (Listings Details)](https://docs.guestway.io/guestway-platform/properties/general-listings-details) — link smart locks to listings from the property's settings.
* [Service Templates](https://docs.guestway.io/guestway-platform/service-templates) — services that link to smart locks (e.g. parking gates, storage rooms).
* [Thermostats](https://docs.guestway.io/guestway-platform/thermostats) — manage the other connected devices used during a stay.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.guestway.io/guestway-platform/smart-locks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.