Repository navigation
Home Screen Widgets
Messages offers two widgets you can put on your home screen. Both show your conversations, refresh on their own when your messages change, and stay blank while the app is locked or in Privacy mode.
A small card with the app name at the top and a + button beside it.
- Shows up to four of your recent conversations, in the same order as the inbox (unread at top if you have that on).
- Each row shows the avatar, the name, the message preview, the time, and a dot when there are unread messages.
- Blocked and archived conversations are not shown.
- Tapping a row opens that conversation. Tapping the app name opens the inbox. Tapping + starts a new chat.
- If there are no conversations yet, it says "No conversations yet".
A card of unread conversations as bubbles.
- Shows up to three unread conversations, each as an avatar, a name, a time, and a snippet bubble.
- A count badge at the top shows the total number of unread conversations.
- When everything is read, it says "All caught up".
- A New message pill at the bottom starts a new chat.
- Tapping a bubble opens that conversation.
- Long-press an empty spot on your home screen.
- Tap Widgets.
- Find Messages in the list.
- Drag either widget to where you want it.
Both widgets can be resized. Drag the edges to make them taller or wider: a taller widget shows more rows (up to four conversations or three unread bubbles), and a wider one gives the preview more room.
- Nothing while the app is locked. If App lock or Privacy mode is on, the widget shows a lock icon and "Tap to unlock" instead of any names or messages. Tapping it opens the app so you can unlock it.
- No blocked or archived chats. They are filtered out, the same as the inbox.
- No message text in a screenshot. Because the widget lives on your launcher, it refuses to hold conversation data whenever the app is locked.
The widgets refresh on their own:
- whenever a message arrives or is sent
- when you change a setting that affects the list, such as unread-at-top
- every 30 minutes in the background, in case a change was missed
They also follow your theme — Light, Dark, Amoled, System default, or Dynamic — and your accessibility contrast setting, so they match the rest of the app.
The widget shows "Tap to unlock" even though the app is not locked
Check that Privacy mode is off in Settings → Privacy mode. Privacy mode locks the widget the same way App lock does.
The widget is empty or says "No conversations yet"
Make sure the app is your default SMS app and has SMS permission, so it can read your conversations. See Getting Started.
The widget has not updated after a new message
Widgets can lag by a few minutes on some launchers. Open the app once to force a refresh, or resize the widget slightly to make Android re-read it.
- Conversations — how the list itself works
- Settings — turning on App lock or Privacy mode
- Privacy and Security