starlight_help/src/content/docs/mobile-notifications.mdx
import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";
import FlattenedSteps from "../../components/FlattenedSteps.astro"; import NavigationSteps from "../../components/NavigationSteps.astro"; import ZulipNote from "../../components/ZulipNote.astro"; import AdminOnly from "../include/_AdminOnly.mdx";
Zulip can be configured to send mobile notifications for DMs, mentions, and alerts, as well as channel messages and followed topics.
<Tabs> <TabItem label="Desktop/Web"> <FlattenedSteps> <NavigationSteps target="settings/notifications" /> 1. Toggle the checkboxes in the **Mobile** column of the **Notification
triggers** table.
</FlattenedSteps>
Zulip Server 12.0+ and Zulip Cloud support end-to-end encrypted (E2EE) mobile push notifications. E2EE ensures that message content and metadata (including the sender's and recipient's names, or channel and topic where the message was sent) are not visible to Apple, Google, or Zulip's Mobile Push Notification Service.
Organization administrators can require end-to-end encryption for message content in mobile push notifications. When this setting is enabled, message content will be omitted when sending notifications to an app that doesn't support end-to-end encryption. Users will see “New message” in place of message text.
See technical documentation for encryption protocol details.
You can customize whether or not Zulip will send mobile push notifications while you are actively using one of the Zulip apps.
<Tabs> <TabItem label="Desktop/Web"> <FlattenedSteps> <NavigationSteps target="settings/notifications" /> 1. Under **Mobile message notifications**, toggle
**Send mobile notifications even if I'm online**, as desired.
</FlattenedSteps>
Start by configuring your notifications settings to make it easy to trigger a notification.
<Tabs> <TabItem label="Desktop/Web"> <FlattenedSteps> <NavigationSteps target="settings/notifications" /> 1. In the **Mobile** column of the **Notification triggers** table, make sure
the **DMs, mentions, and alerts** checkbox is checked.
1. Under **Mobile message notifications**, make sure the **Send mobile
notifications even if I'm online** checkbox is checked.
</FlattenedSteps>
Next, test Zulip push notifications on your mobile device.
<Tabs> <TabItem label="Mobile"> <Steps> 1. [Download](https://zulip.com/apps/) and install the Zulip mobile app if you have not done so already. 1. If your Zulip organization is self-hosted (not at `*.zulipchat.com`), [check](/help/mobile-notifications#enabling-push-notifications-for-self-hosted-servers) whether push notifications have been set up. If they were set up recently, you will need to [log out](/help/logging-out) of your account. 1. [Log in](/help/logging-in) to the account you want to test. 1. Ask *another* user (not yourself) to [send you a direct message](/help/starting-a-new-direct-message). You should see a Zulip message notification in the **notifications area** on your device. </Steps> </TabItem> </Tabs>Some Android vendors have added extra device-level settings that can impact the delivery of mobile notifications to apps like Zulip. If you're having issues with Zulip notifications on your Android phone, we recommend Signal's excellent troubleshooting guide, which explains the notification settings for many popular Android vendors.
Android users using microG: we have heard reports of notifications working if microG's "Cloud Messaging" setting is enabled.
To enable push notifications for your organization:
<Steps> 1. Your server administrator needs to register your Zulip server with the [Zulip Mobile Push Notification Service](https://zulip.readthedocs.io/en/stable/production/mobile-push-notifications.html). 1. For organizations with more than 10 users, a user [who can manage plans and billing](/help/self-hosted-billing#configure-who-can-manage-plans-and-billing) needs to sign up for a [plan](https://zulip.com/plans/#self-hosted) for your organization. </Steps>