TTLock Widget on iPhone and Android: One-Tap Unlock Setup

• The lock already added to your account and working normally from inside the app.
• Bluetooth turned on and permission granted to the app, since the widget still talks to the lock over Bluetooth even when it is not open.
• On Android, Location and/or Nearby devices permission, which the system requires for Bluetooth scanning regardless of widget use.
• Background app refresh allowed on iOS, and battery optimisation disabled for the app on Android, so the widget can reach the lock reliably.

iPhone

1. Touch and hold an empty area of the home screen until the icons jiggle.
2. Tap the add button and search for the app in the widget gallery.
3. Choose the lock-specific widget size, select which lock it should control if you have more than one, and place it on the home screen.
4. Confirm Bluetooth permission is granted under Settings > Privacy & Security > Bluetooth for the app.
5. Tap the widget once to test it while standing near the lock.

Android

1. Touch and hold an empty area of the home screen and choose Widgets.
2. Find the app in the list and drag its unlock widget onto the home screen.
3. Select the lock to bind the widget to, if prompted.
4. Grant Location and Nearby devices permissions if not already allowed, and exclude the app from battery optimisation so Android does not suspend its Bluetooth background activity.
5. Tap the widget near the lock to confirm it unlocks.

• Bluetooth switched off, either system-wide or revoked for the app, is the single most common cause of a widget tap doing nothing.
• Being out of Bluetooth range. The widget cannot reach further than a normal Bluetooth connection, typically a few metres, regardless of how the tap feels instant when close.
• Aggressive battery optimisation on Android that suspends the app's background Bluetooth process, making the first tap after a period of inactivity slow or unresponsive.
• iOS background refresh disabled for the app, which can delay the widget's connection to the lock.
• The lock already connected to another phone or the stock manufacturer app, leaving no free Bluetooth slot for the widget to use.

Because tap-to-unlock removes the step of confirming identity within the app, it trades a small amount of security for convenience — worth weighing before enabling it for every lock.

• Adding the widget on a phone that is never locked itself. Anyone who picks up an unlocked phone near the door can tap the widget without needing your app password or biometrics.
• Leaving the widget visible on a lock screen where the platform allows it, which can let someone unlock the door without unlocking the phone first.
• Forgetting the widget still uses Bluetooth range only, so it will not work for unlocking remotely; that needs a gateway and remote unlock instead.
• Assuming a failed tap means the door is locked. Always check for feedback from the lock itself, since a silent failure could mean the door was already unlocked from another attempt.