What This Screen Does
This is where you update the settings for an existing door lock. Think of it like adjusting the rules for a door — you can change how it behaves (auto-locking) and set the hours when it should be open or closed. The lock’s name and external ID are shown for reference but cannot be changed here.
How to Get There
Open the dashboard.
In the left-hand menu, click Locks.
Find the lock you want to edit and click on it (or click an edit button next to it).
You are now on the Edit Lock screen.
Step-by-Step Guide
1. Review Lock Details
At the top of the form you will see basic information about the lock. These fields are read-only and cannot be changed from this screen:
Field | Required | What to Enter |
Name | Yes (read-only) | The name of the lock. This is set when the lock is created and cannot be edited here. |
External ID | Yes (read-only) | The identifier used to link this lock to the external lock system. Cannot be edited here. |
If the name or external ID is wrong, you will need to update it in the external lock system or contact your administrator.
2. Configure Auto Lock Settings
Below the lock details you will find three toggle switches. These control how the door behaves automatically:
Toggle | Required | What It Does |
Use auto lock | No | When turned on, the door will automatically lock itself after being opened. This is useful for doors that should never stay open unattended. |
Automatically lock doors outside opening hours | No | When turned on, the system will lock the door when the current time is outside the opening hours you set below. |
Automatically unlock doors inside opening hours | No | When turned on, the system will automatically unlock the door when the current time is within the opening hours you set below. |
You can turn these on or off in any combination.
The last two toggles work together with the Opening Hours section below. If you enable them, make sure your opening hours are set correctly.
3. Set Opening Hours
The Opening Hours section lets you define when the door should be open and closed for each day of the week. Each day has two time fields:
Field | Required | What to Enter |
Open | Yes | The time the door should open (or be considered “within opening hours”). Uses 24-hour format (e.g. 06:00). |
Closed | Yes | The time the door should close (or be considered “outside opening hours”). Uses 24-hour format (e.g. 22:00). |
The days shown are:
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
How to set a time:
Click the Open time picker for the day you want to change.
Select the opening time using the time picker. Times are in 24-hour format (no AM/PM).
Click the Closed time picker for the same day.
Select the closing time.
Repeat for every day of the week.
By default, each day is set to 00:00 (open) to 23:59 (closed), meaning the door is considered open all day.
If you want a day to be fully locked, set the open and closed times to the same value (e.g. both 00:00).
4. Save Changes
Click the Save Changes button at the bottom-right of the form.
The system will:
Validate all your inputs.
Send the updated settings to the server.
Navigate you back to the previous page.
You will see a green “Update success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Save Changes"
|
v
Form validates all fields (Yup schema)
|
v
Opening hours are converted to time strings (HH:mm:ss format)
|
v
API call: LocksService.edit({ id, body: updatedLockData })
|
v
Server updates the lock record with new settings
|
v
Success notification "Update success!" appears
|
v
You are navigated back to the previous page
Troubleshooting
“I cannot change the lock name or External ID”
The Name and External ID fields are read-only on this screen. They are disabled on purpose.
These values are typically set by the external lock system when the lock is first registered.
If you need to change them, contact your administrator or update the information in your external lock provider.
“I clicked Save Changes but nothing happened”
Make sure all required fields are filled in. The Name and External ID should already be filled from the existing lock data.
Check if there are any red error messages below the fields.
If the button shows a loading spinner, the request is still in progress — wait a moment for it to finish.
“The opening hours are not saving correctly”
Make sure you have set both the Open and Closed time for each day.
The time picker uses 24-hour format. Double-check that you selected the right hour (e.g. 14:00 for 2 PM, not 02:00).
If a time field appears empty, click it and pick a time before saving.
“The door is not locking/unlocking automatically”
Check that the Use auto lock toggle is turned on.
If you want the door to lock outside opening hours, make sure the Automatically lock doors outside opening hours toggle is also turned on.
If you want the door to unlock during opening hours, make sure the Automatically unlock doors inside opening hours toggle is turned on.
Verify that the Opening Hours for the current day are set correctly. The system uses these times to decide when to lock and unlock.
“I see an error after clicking Save Changes”
A red error notification will appear. Read the message carefully — it usually explains what went wrong.
Common causes: a network issue, the lock no longer existing in the system, or a server timeout.
Try refreshing the page and making your changes again.
If the problem continues, contact support and include the error message.
“The page is blank or the lock data is not loading”
The screen loads the lock details when you first open it. If your internet connection is slow or interrupted, the data may not appear.
Try refreshing the page.
Make sure the lock ID in the URL is correct. If the lock was deleted, you will not be able to edit it.
“I want to set a day as fully closed but there is no ‘closed all day’ option”
Set both the Open and Closed times to the same value (for example, both to 00:00).
This effectively means there are zero opening hours for that day, so the auto-lock features will treat the door as closed all day.
“The time picker shows AM/PM but I expected 24-hour format”
The time picker is configured to use 24-hour format (no AM/PM). If you see AM/PM, this may be a browser or device setting override.
Try selecting the correct hour directly. The system will still save the time in 24-hour format regardless of how the picker displays it.