TTLock passcode types: permanent, timed, one-time, recurring, erase and custom

A passcode in the TTLock app is not one thing but six. They differ in how long they work, whether you need a gateway to create them and what happens when nobody types them in on the first day.

In short TTLock has six passcode types: one-time, permanent, timed, recurring, erase and custom. The first five are calculated by an algorithm, so they can be created without a gateway and without any connection to the lock, but their validity runs in whole hours and a permanent or timed passcode must be used on the lock within 24 hours of its start time. A custom passcode has digits you choose and a validity set to the minute, but it has to be written to the lock, either by phone at the door or remotely through a gateway. For guests, use a timed passcode or a custom one with an end date.

Two schemes: random passcodes and custom passcodes

The TTLock Open Platform documentation, written for developers, splits passcodes into two schemes. Most of the surprises in daily use come from this split.

  • Random passcode. When a lock is first added to an account, the lock and the TTLock server receive the same algorithm and the same key data. When you ask for a passcode, the server calculates it, and the lock can check the digits by itself. That is why such a code opens a lock that has never been online. It has 6 to 9 digits, depending on the type and the validity period, and you cannot choose them.
  • Custom passcode. You pick the digits, 4 to 9 of them. The lock cannot derive them from the algorithm, so the code must be stored in its memory: over Bluetooth with a phone at the door, or remotely through a gateway or a lock with built-in Wi-Fi.

In the app both schemes sit side by side in one list of passcode types. The names below follow the English TTLock help centre as read on 13 November 2026. Labels can change between app versions.

The six passcode types in one table

TypeHow long it worksConditionGateway needed to create it
One-timeone unlockonly within 6 hours of the start timeno
Permanentno end datefirst use within 24 hours of the start timeno
Timedfrom a chosen hour to a chosen hourfirst use within 24 hours of the start timeno
Recurringin a fixed time window: daily, on workdays, at weekends or on one day of the weekat least one use after the start timeno
Erasetyped on the lock, it disables the other passcodesaffects passcodes that have already been usedno
Custompermanent or timed, accurate to the minutemust be stored in the lock's memoryyes, unless you are at the lock with your phone

Four rules of random passcodes that catch people out

Validity runs in whole hours

According to the documentation, a random passcode is accurate to the hour. Set the start to 19:20 and the code starts working at 19:00. For periods longer than a year the accuracy drops to a month: the day and time of the start and the end have to match, for example 18 October to 18 October two years later.

First use within 24 hours

A permanent or timed passcode must be entered on the lock at least once within 24 hours of its start time. Otherwise it is suspended for security reasons. This is the most common reason behind "the code does not work". A guest who was due on Friday at 3 pm and turns up on Saturday evening will be standing at the door with a suspended code, even though the booking runs until Sunday.

A one-time passcode lives for 6 hours

It opens the door once, and only within 6 hours of its start time. It suits a courier or a repair technician who is already on the way, not someone who will come "sometime tomorrow".

One timed passcode per pair of times

For the same start and end, a lock has only one timed passcode. To get a different one you have to shift the start or the end. For one-time passcodes there are 200 with the same start time, and for permanent ones 20.

Custom passcodes: your digits, minute accuracy

A custom passcode can only be permanent or timed, but its validity is set to the minute. The documentation states the 24-hour first-use condition for random passcodes and does not mention it for custom ones.

The price is lock memory and connectivity. The passcode guide in the documentation speaks of 150 custom passcodes in the lock's memory, while the interface reference gives 250 at most. Once the memory is full, the lock refuses a new code until old ones are deleted. Without a gateway a custom passcode can only be added with a phone at the door.

TTLock offline passcodes: what works without a gateway

"Offline passcode" is not an official type. People use the phrase for the random passcodes, because the server calculates them and the lock verifies them without any connection. You can create one from anywhere, for a lock that has no gateway at all.

The TTLock help centre lists what you cannot do remotely without a gateway: change or delete a passcode, create a custom passcode, unlock the door, get unlock records uploaded automatically or read the lock's status. Without a gateway each of these is done by phone within Bluetooth range.

For a rental this has a plain consequence. A guest who leaves early keeps a working code until the original end time, unless somebody walks up to the door with a phone. Getting a gateway online is covered in TTLock gateway setup.

Changing and deleting passcodes

  • Only a passcode that has been used on the lock at least once can be changed. Both the help centre and the developer documentation say so.
  • Changing it on the keypad. The help centre gives the command: *10#, the current code, #, the new code, #, the new code again, #. The other way is to change it in the app as the lock's administrator.
  • Deleting it remotely needs a gateway. Without one you have to be at the lock.
  • Everything at once. There are two routes. An erase passcode typed on the keypad invalidates the passcodes that have been in use. The Reset button on the passcode list in the app removes every passcode from the lock and the server and generates new key data, so old random passcodes no longer match. Reset is done at the lock over Bluetooth and cannot be done through a gateway.

Which passcode for whom in a rental or a small hotel

WhoPasscode typeWatch out for
Guest for a staytimed, or custom timedwith a random code: whole hours and 24 hours for the first entry
Cleaner on fixed daysrecurring, for example workdays from 10 am to 3 pma separate code for each person
Technician on the wayone-time6 hours from the start time
Owner and familypermanent, or custom permanentnever share it with staff
End of season, new cleaning companyerase, or a passcode resetit also removes the codes of guests who are still staying

What to write to a guest so that the code gets typed in without a phone call to you is covered in the door code message template.

By hand in the TTLock app or automatically with PinRoom

By hand in the TTLock app. For every booking you open the app, pick the lock, set the hours and copy the code into a message for the guest. If the guest also passes a gate or a building door, you repeat it on the second lock and send two codes. When dates change or a booking is cancelled, you have to remember to fix or delete the code. With a few bookings a month that is enough, and it costs nothing.

Automatically with PinRoom. PinRoom uses one type only: a custom timed passcode. It draws six digits, writes the same code through the gateway to the room lock and to the shared entrance, sets it to run from check-in time to check-out time and sends the guest a message. A date change moves the validity, a cancellation deletes the code, and one hour after the stay ends the code is removed from the lock's memory, so the memory does not fill up. It is a code stored in the lock, and the TTLock documentation does not tie such codes to the 24-hour first-use condition. The requirement is a gateway within range of every lock.

PinRoom takes bookings from WuBook, from Booking.com through Beds24 and from iCal calendars, as described on the page about TTLock and Booking.com. Rates are on the pricing page, and locks with gateways are in the lock catalogue. To ask about your own property, use the contact form.

Sources, read on 13 November 2026: TTLock Open Platform, passcode guide, random passcode types and custom passcode; TTLock help centre: access permission, gateway and FAQ. The description of PinRoom comes from the software as of 13 November 2026. PinRoom is not affiliated with the maker of the TTLock app.

Questions about TTLock passcodes

How many passcode types does TTLock have?

Six: one-time, permanent, timed, recurring, erase and custom. The first five are random passcodes calculated by an algorithm, and the sixth has digits chosen by the user and is stored in the lock's memory.

Does a TTLock passcode work without internet or a gateway?

Yes. The lock checks the code by itself, so no internet is needed to open the door. Random passcodes can also be created without a gateway. A gateway is needed to add a custom passcode remotely and to change or delete a passcode remotely.

Why did my timed passcode stop working before its end date?

Most often because nobody entered it on the lock within 24 hours of its start time. According to the TTLock documentation, a random timed or permanent passcode is then suspended for security reasons and a new one has to be issued.

How long does a TTLock one-time passcode last?

It opens the door once, and only within 6 hours of its start time. After that it expires even if nobody has used it.

Can I choose my own digits for a TTLock passcode?

Yes, with a custom passcode of 4 to 9 digits. It has to be written to the lock by phone over Bluetooth or remotely through a gateway. Random passcodes get their digits from the algorithm.

How many passcodes can a TTLock lock store?

For custom passcodes the TTLock Open Platform documentation gives 150 in one place and 250 at most in another, so it is safer to plan for the lower number and delete codes once they expire. Random passcodes are verified by the algorithm.

How do I delete all passcodes at once?

With an erase passcode typed on the keypad, or with the Reset button on the passcode list in the app. Reset is done at the lock over Bluetooth. It removes every passcode, including those of guests who are still staying.

See the panel on a demo property

The demo opens without login and nothing you do there is saved or sent. The panel is in Polish for now.