Repository navigation
Troubleshooting
The problems people hit most, and what to do about them.
This is almost always because the app is not your phone's default SMS app. Android only delivers texts to one app.
Android Settings → Apps → Default apps → SMS app- Make sure Messages is selected
- Force stop and reopen the app
Also check you granted the SMS permission. If you skipped it, the app cannot see anything already on the phone.
Work down this list:
-
Settings → Notificationsis on -
Android's own permission is granted:
Android Settings → Apps → Messages → Notifications - Not switched off for that one chat — open the chat, tap the name, and check Notification profile. A conversation with its own profile can be silent or turned off in Android's settings
- Not blocked — blocked numbers never notify you
- Receive sound is separate from notifications. If notifications are not appearing at all, sound is not the problem
More detail in Notifications.
That is your launcher's doing, not the app's.
The app publishes an unread count correctly, but plenty of launchers — including the stock Android launcher — cannot show numbers and only draw a dot. There is nothing to fix in Messages.
If you want to see a number, try a launcher that supports badges, such as Lawnchair.
Android announcing that a notification channel was deleted. The app switches notification sounds by keeping each choice in its own channel and removing the ones you are not using, and Android announces every removal.
It is harmless. Tidying this up is on the list.
- Confirm you have two SIMs, both enabled
- Check
Settings → SIM cardlists more than one - Grant the Phone permission if you declined it
More in Using Two SIM Cards.
Some senders use a name instead of a phone number — "A1-SRB", "MY-BANK", and so on. There is no number to reply to, so the app:
- does not show a Reply button on the notification
- does not show a message box in that chat
- tells you the sender cannot receive replies
This is intentional. It matches how other messaging apps handle senders with no number.
If the sender really does have a number and the app has it wrong, please report it with a screenshot.
Correct, and this surprises people. Messages caught by a blocked keyword go to Spam & Blocked → Messages, not Trash.
The wording inside the keyword dialog still says "Trash". That text is out of date and we are fixing it. Where the messages really are: Settings → Spam & Blocked → Messages.
Blocking in this app stops messages only. It does not block phone calls — that is an Android feature, not something the app does.
The confirmation wording suggests otherwise, which is misleading. We are fixing the wording.
They are probably not gone. Check, in this order:
-
Trash —
Settings → Trash - Archived — the archive icon in the conversation list header
- Spam & Blocked — if you have blocking set up
If they really are missing, restoring a backup is the way back. See Backup and Import.
Restore replaces everything with the contents of the backup — that is what it is for. The other option, Merge with existing messages, is the safe one.
If you restored the wrong file and have no backup of what was there before, the old messages cannot be recovered. This is the one action in the app that is not undoable, so read the confirmation carefully.
Usually the other phone is off, out of coverage, or the number is wrong. A few things to try:
- Check the number is right
- Make sure the other phone has signal
- If you have two SIMs, try switching SIM and retrying
- Restart your phone — a genuine mobile network problem sometimes clears
Large pictures go over mobile data, which can fail on a weak connection. Try again on Wi-Fi, or send a smaller picture.
Note that picture messages are sent as MMS, which normally uses mobile data rather than Wi-Fi. Some networks will not send MMS over Wi-Fi at all, so if you have no signal, picture messages can fail while text messages still work.
That is Privacy mode working. Turn it off at Settings → Advanced → Privacy mode, take your screenshot, then turn it back on.
It asks once, and then asks again later if you decline. To set it without the prompt, go to:
Android Settings → Apps → Default apps → SMS app
Large pictures go over mobile data, which can fail on a weak connection. Try again on Wi-Fi, or send a smaller picture.
Note that picture messages are sent as MMS, which normally uses mobile data rather than Wi-Fi. Some networks will not send MMS over Wi-Fi at all, so if you have no signal, picture messages can fail while text messages still work.
If picture messages fail on one SIM but work on another, check Settings → Advanced → MMS support — it reports what each carrier publishes for MMS on each card.
Check that Privacy mode is off in Settings → Privacy mode. Privacy mode locks the widget the same way App lock does. See Home Screen Widgets.
Open an issue on GitHub. The more detail the better:
- Your phone model and Android version
- What you did, what you expected, what happened instead
- A screenshot, if you are comfortable sharing one
There is also Settings → Advanced → Diagnostics, which builds a report about your phone and the app. Attaching that to an issue saves a lot of back and forth.
Still stuck? Ask on GitHub — someone will look.