Skip to content

Troubleshooting

Anindra edited this page Nov 10, 2026 · 2 revisions

Troubleshooting

The problems people hit most, and what to do about them.


I am not receiving any messages

This is almost always because the app is not your phone's default SMS app. Android only delivers texts to one app.

  1. Android Settings → Apps → Default apps → SMS app
  2. Make sure Messages is selected
  3. 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.


I am not getting notifications

Work down this list:

  1. Settings → Notifications is on
  2. Android's own permission is granted: Android Settings → Apps → Messages → Notifications
  3. 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
  4. Not blocked — blocked numbers never notify you
  5. Receive sound is separate from notifications. If notifications are not appearing at all, sound is not the problem

More detail in Notifications.


The app icon has no number, just a dot

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.


"1 category removed" keeps appearing in my settings

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.


The SIM switch button has not appeared

  • Confirm you have two SIMs, both enabled
  • Check Settings → SIM card lists more than one
  • Grant the Phone permission if you declined it

More in Using Two SIM Cards.


I cannot reply to a message

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.


A blocked message is not in Trash

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.


I blocked a number but I am still getting calls

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.


My messages disappeared after an app update

They are probably not gone. Check, in this order:

  1. Trash — Settings → Trash
  2. Archived — the archive icon in the conversation list header
  3. Spam & Blocked — if you have blocking set up

If they really are missing, restoring a backup is the way back. See Backup and Import.


Restoring a backup wiped my messages

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.


A message says "Tap to retry" and keeps failing

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

A picture did not send

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.


The screen will not let me take a screenshot

That is Privacy mode working. Turn it off at Settings → Advanced → Privacy mode, take your screenshot, then turn it back on.


The app asks to be my default SMS app constantly

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


A picture did not send and I want to know why

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.


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. See Home Screen Widgets.


How do I report a bug

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.

Clone this wiki locally