---
title: "Push Notifications FAQ"
slug: "push-notifications-faq"
updated: 2026-05-18T20:44:58Z
published: 2026-05-18T21:39:24Z
canonical: "docs.rocket.chat/push-notifications-faq"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Push Notifications FAQ

****Why do I see the error ‘Server notifications are misconfigured!’?****

This error appears when your server is not correctly configured to send push notifications. As a result, mobile push notifications may not be delivered.

In most cases, this can be resolved by verifying the following:

- **Rocket.Chat version:** Ensure your server is running **version 0.74.3 or later**.
- **Rocket.Chat Cloud registration:** Your server must be registered with Rocket.Chat Cloud to enable push notifications. To verify registration status, go to: `https://<your-server>/admin/cloud`. If your server is not registered, complete the registration process on that page.

If the issue persists after confirming these steps, restart your server and re-test push notifications.

****Why are my users not receiving push notifications?****

If users are not receiving push notifications on mobile devices, verify the following configuration and conditions:

- **Push notifications are enabled:** Go to **Manage → Workspace → Settings → Push** and confirm that push notifications are enabled.
- **Server connectivity:** Ensure your server has outbound internet access and can reach: `https://gateway.rocket.chat`
- **Push notification quota:** Community workspaces are limited to **10,000 push notifications per month**. If the quota is exceeded, push notifications will not be delivered until the monthly limit resets.
- **User notification settings:** Confirm that users:
  - Have not disabled notifications in their account preferences
  - Have not muted the specific room
  - Have allowed notifications at the mobile OS level (iOS/Android settings)

If all of the above are correctly configured and the issue persists, restart the server and re-test. You can also review server logs for push-related errors.

****Why do notifications sometimes stop working in large channels?****

Notifications may stop working if the number of members in a channel exceeds the configured notification limit.

You can adjust this setting under **Manage → Workspace → Settings → General → Notifications**

****Can I hide message content in push notifications for compliance reasons (e.g., HIPAA)?****

Yes. To hide message content in push notifications, go to **Manage → Workspace → Settings → Push**

Under the **Privacy** section, enable **Hide message content from Apple and Google (and the Gateway, if enabled)**.

When enabled, only a message ID is sent in the push notification, and the mobile app securely fetches the message content. Note that this feature requires your workspace to be subscribed to a [premium plan.](/v1/docs/our-plans)

****Do I need to restart Rocket.Chat after changing push settings?****

Yes. Many push-related settings, such as **Enable**, **Enable Gateway**, **Gateway URL**, and **Production**, require a server restart before the changes take effect.

****Why does the “Send a test push to my user” button not work?****

If the test push is not received, verify the following:

- You’re logged into the Rocket.Chat mobile app with the same account the test is being sent to.
- The mobile app is **minimized or closed**. Push notifications are not displayed while the app is open and active.
- Push notifications are enabled and properly configured under **Manage → Workspace → Settings → Push**.

****Can I test push notifications for other users?****

No. The **“Send a test push to my user”** button only works for the currently logged-in user. It cannot be used to send test push notifications on behalf of other users.

****Can I use a custom push gateway instead of Rocket.Chat’s?****

Yes. To use your own push gateway:

- Disable the **Enable Gateway** toggle.
- Provide your own certificates and keys in the **Certificates and Keys** section.
- This setup is typically required for white-labeled mobile apps or premium deployments.

****What happens when the monthly notification limit is reached?****

Once the monthly quota is exhausted, Rocket.Chat stops sending push notifications.

- **Community workspaces** are limited to 10,000 push notifications per month.
- To continue receiving push notifications, upgrade to a [**premium plan.**](/v1/docs/our-plans)