Push notifications on Android: setup and troubleshooting

Why aren't your Coachful push notifications working on Android?

Push notifications on Android can go silent for a dozen different reasons — a missed permission prompt, an aggressive battery saver, or a single toggle buried four menus deep. If you're a coach waiting on a client message, or a client who just missed a session reminder, every skipped notification costs you. This guide walks through the complete setup and every common fix for push notifications on Android for the Coachful app.

TL;DR — Quick answers

• First time? Install the Coachful app via app.coachful.co/mobile, sign in, and accept the notification permission prompt.
• Notifications stopped? Check Android notification permissions → Battery optimization → Do Not Disturb, in that order.
• Still nothing? Sign out and back in to refresh the push token, then clear the app cache.
• On a Samsung, Xiaomi, OnePlus, or Huawei device? Manufacturer-specific battery savers are almost always the culprit — see the device-specific section below.

How Coachful push notifications work on Android

Coachful is built as a progressive web app (PWA) with a native Android shell delivered via Capacitor. When you install the app through app.coachful.co/mobile and open it on your Android device, the app registers a unique push token with Firebase Cloud Messaging (FCM). That token is stored in your Coachful account and used to route real-time alerts — new chat messages, session reminders, program task due dates, habit check-ins, and squad activity — directly to your device.

If the token goes stale (because of a reinstall, a cache wipe, or a long offline period), Android stops delivering notifications even though everything looks fine in the app settings. That's why the "sign out and sign back in" fix works: it forces the app to request and register a fresh FCM token.

Coachful's real-time messaging is powered by Stream, so chat push notifications follow Stream's delivery pipeline before they ever reach FCM. That means end-to-end delivery depends on: your Coachful notification preferences → Stream's push channel → FCM → Android OS → your device's battery/power manager. A block anywhere in that chain silences alerts.

Step 1 — Grant notification permission on Android

Android 13 (API 33) and later require apps to explicitly request notification permission. If you dismissed that prompt on first launch, notifications are off entirely until you re-enable them manually.

1. Open your Android Settings app.
2. Tap Apps (or App Management on some skins) and find Coachful.
3. Tap Notifications.
4. Toggle Allow notifications to On.
5. Make sure individual notification categories — Messages, Session reminders, Program updates — are also enabled. Android 13+ breaks permissions into channels, so a global "on" doesn't automatically re-enable every channel.

On Android 12 and earlier, open Settings → Apps → Coachful → App notifications and flip the master toggle on.

Step 2 — Check your in-app notification preferences

Even if Android permission is granted, Coachful lets you control which events trigger a push. A coach might want squad messages but not every habit completion; a client might want session reminders but not marketing emails.

1. Open the Coachful app and tap your profile avatar in the bottom nav.
2. Go to Settings → Notifications.
3. Review each toggle: Direct messages, Squad activity, Session reminders, Program tasks, Habit reminders, Billing alerts.
4. Enable the categories you want and tap Save.

Changes sync instantly — you don't need to restart the app.

Pro tip: Coaches managing multiple squads often turn off per-message squad notifications and keep only the "unread summary" alert. This dramatically cuts notification noise without missing anything important. You can fine-tune this under Settings → Notifications → Squad activity → Digest mode.

Step 3 — Disable battery optimization for Coachful

This is the most common cause of missed notifications on Android, especially on devices running Android 8 (Oreo) and above. Android's battery optimization — known as "Doze mode" — kills background processes for apps it deems inactive, which includes FCM connections.

1. Go to Settings → Apps → Coachful.
2. Tap Battery (or Battery usage).
3. Select Unrestricted (on Android 12+) or Don't optimize / No restrictions on older versions.

On stock Android you can also navigate via Settings → Battery → Battery optimization → All apps → Coachful → Don't optimize.

Step 4 — Handle manufacturer battery savers (Samsung, Xiaomi, OnePlus, Huawei)

Stock Android battery optimization is one layer. Every major Android manufacturer adds its own aggressive power management on top. Here's where to look on the most common devices:

Samsung (One UI)

1. Go to Settings → Battery and device care → Battery → Background usage limits.
2. Make sure Coachful is not listed under Sleeping apps or Deep sleeping apps.
3. If it is, tap the app and select Remove.
4. Also check Settings → Apps → Coachful → Battery → Unrestricted.

Xiaomi / MIUI / HyperOS

1. Go to Settings → Apps → Manage apps → Coachful → Battery saver and set to No restrictions.
2. Then go to Settings → Battery → App battery saver → Coachful → No restrictions.
3. Open the Security app → Battery → App battery usage and exclude Coachful.
4. In MIUI, you may also need to enable Autostart for Coachful: Security → Autostart → Coachful → On.

OnePlus / OxygenOS

1. Go to Settings → Battery → Battery optimization → All apps → Coachful → Don't optimize.
2. Also check Settings → Apps → Coachful → Battery usage → Allow background activity.

Huawei / Honor (EMUI)

1. Go to Settings → Apps → Apps → Coachful → Battery → Enable background activity.
2. Then open Phone Manager → Protected apps and add Coachful to the protected list.

Coaches using Coachful on Samsung devices tell us the "Sleeping apps" list is the single biggest culprit — Android quietly adds apps it hasn't seen recently, which includes Coachful if a client hasn't messaged in a few days. Check this list monthly if you rely on push alerts for new client inquiries.

Step 5 — Check Do Not Disturb and Focus modes

Android's Do Not Disturb (DND) mode and Focus modes (available from Android 12+) can silently swallow notifications even when every other setting is correct.

1. Swipe down to open Quick Settings and make sure DND / Focus is not active.
2. If you want DND on but still receive Coachful alerts, go to Settings → Sound & vibration → Do Not Disturb → Apps and add Coachful as an exception.
3. On Android 12+, go to Settings → Digital Wellbeing → Focus mode and ensure Coachful is not in the list of paused apps.

Step 6 — Refresh your push token (sign out and back in)

If you've verified every setting above and notifications still don't arrive, the most likely remaining cause is a stale or corrupted FCM push token. This happens after reinstalls, cache clears, or extended offline periods.

1. Open the Coachful app.
2. Go to Profile → Settings → Account → Sign out.
3. Close the app completely (swipe it away from the recent apps tray).
4. Reopen Coachful and sign back in with your credentials.
5. When prompted, allow notifications.

Signing back in forces a new FCM token registration. Most users see notifications resume within 2–3 minutes of completing this step.

Step 7 — Clear the app cache

A corrupted cache can cause the app to behave unpredictably, including failing to register for push notifications properly.

1. Go to Settings → Apps → Coachful → Storage.
2. Tap Clear cache. (Do not tap "Clear data" unless instructed — that logs you out and wipes local storage.)
3. Reopen the app and sign in if prompted.

Common mistakes and troubleshooting

Mistake 1 — Assuming Android permission is on when it's not

Many users tap "Don't allow" on the first-launch notification prompt without realizing it disables all alerts permanently. Android does not re-show this prompt automatically. You must go to Settings → Apps → Coachful → Notifications and manually enable it. This is the first thing to check — even before battery settings.

Mistake 2 — Enabling global notifications but leaving channels off

Android 8+ uses notification channels. Coachful creates separate channels for messages, reminders, and program updates. If you previously disabled a specific channel (or if it was off by default), the global "notifications on" toggle won't fix it. Scroll through all channels under Settings → Apps → Coachful → Notifications and enable each one individually.

Mistake 3 — Reinstalling the app without signing back in

Uninstalling and reinstalling Coachful generates a new device registration, but if you restore from a backup or auto-sign-in via a saved password, the old push token may be reused — and it's no longer valid. Always sign out and sign back in fresh after a reinstall.

Mistake 4 — Relying on Wi-Fi only when FCM needs a stable connection

FCM push notifications are delivered over a persistent background connection. Unreliable Wi-Fi (like hotel or café networks that drop idle connections) will interrupt delivery. If notifications work on mobile data but not Wi-Fi, your network may be blocking the FCM ports (5228–5230). Ask your network admin, or switch networks to confirm.

Mistake 5 — Not updating the Coachful app

Coachful ships updates regularly. Older app versions may have push notification bugs that are already fixed. Go to the Google Play Store → My apps → Coachful and tap Update if one is available. If you installed the app via app.coachful.co/mobile as a PWA, pull down to refresh the browser to check for updates.

Mistake 6 — Ignoring VPN interference

Some VPN configurations route traffic through servers that block FCM. If you use a VPN, try disabling it temporarily and see if notifications resume. If they do, add an exception for FCM domains (fcm.googleapis.com) in your VPN app's split-tunneling settings.

Pro tips for coaches

Push notifications aren't just a convenience — they're a retention lever. Clients who get timely reminders for their program tasks and session bookings are significantly more likely to complete their programs and re-enroll. Here's how to make notifications work harder for your coaching business:

• Use session reminders strategically. Coachful sends automatic session reminders via push, email, and in-app. Encourage every new client to complete the Android setup steps above during onboarding — make it part of your intake checklist so no one falls through the cracks.
• Leverage squad notifications. If you're running a group cohort, community squads drive daily engagement. Clients who get push notifications for new squad posts return to the app 3x more often than those who don't.
• Use Michelle (your AI assistant) to set reminders. Inside the coach dashboard, ask Michelle to schedule a follow-up or task reminder for a client — it surfaces in their push notifications automatically without you having to manage it manually.

Want to set all of this up without the back-and-forth? Coachful handles push delivery, session reminders, chat alerts, and habit check-ins in one platform — no third-party notification tools needed. Coaches on the Scale plan get priority delivery and advanced notification customization baked in.

When to contact Coachful support

If you've worked through every step above and notifications still aren't arriving, it's time to escalate. Before reaching out, collect the following so the support team can investigate quickly:

• Your Android version and device model (e.g., Samsung Galaxy S24, Android 14).
• Coachful app version (visible under Profile → Settings → About).
• Whether the issue affects all notification types or just specific ones (e.g., only squad messages, not session reminders).
• Whether notifications work on another device or on iOS.
• The approximate time and date of the last notification you successfully received.

You can reach support via the in-app chat (tap the ? icon in the dashboard) or browse related guides at help.coachful.co.

Ready to get every notification — and never miss a client moment?

Push notifications on Android are critical for staying connected to your clients, your sessions, and your coaching programs. Once you've got them dialed in — permissions granted, battery optimization disabled, push token fresh — Coachful becomes a truly real-time coaching experience: instant chat alerts, timely session reminders, habit nudges, and squad activity, all delivered straight to your lock screen.

If you're not yet on Coachful, now's a great time to see what a fully integrated coaching platform feels like. Start your free trial and have your first program, squad, and booking page live in under an hour — with Android push notifications working from day one.