Mobile notifications

Zulip can be configured to send mobile notifications for DMs, mentions, and alerts, as well as channel messages and followed topics.

  1. Go to Notifications.

  2. Toggle the checkboxes in the Mobile column of the Notification triggers table.

End-to-end encryption (E2EE) for mobile push notifications

Zulip Server 11.0+ and Zulip Cloud support end-to-end encryption for mobile push notifications. Support is coming soon to the Zulip mobile app. Once implemented, all push notifications sent from an up-to-date version of the server to an updated version of the app will be end-to-end encrypted.

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 details.

Require end-to-end encryption for mobile push notifications

This feature is only available to organization owners and administrators.

  1. Go to Organization settings.

  2. Under Notifications security, toggle Require end-to-end encryption for push notification content.

Mobile notifications while online

You can customize whether or not Zulip will send mobile push notifications while you are actively using one of the Zulip apps.

  1. Go to Notifications.

  2. Under Mobile message notifications, toggle Send mobile notifications even if I'm online, as desired.

Testing mobile notifications

Start by configuring your notifications settings to make it easy to trigger a notification.

  1. Go to Notifications.

  2. In the Mobile column of the Notification triggers table, make sure the DMs, mentions, and alerts checkbox is checked.

  3. Under Mobile message notifications, make sure the Send mobile notifications even if I'm online checkbox is checked.

Next, test Zulip push notifications on your mobile device.

  1. Download and install the Zulip mobile app if you have not done so already.

  2. If your Zulip organization is self-hosted (not at *.zulipchat.com), check whether push notifications have been set up. If they were set up recently, you will need to log out of your account.

  3. Log in to the account you want to test.

  4. Ask another user (not yourself) to send you a direct message. You should see a Zulip message notification in the notifications area on your device.

Troubleshooting mobile notifications

Checking your device settings

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.

Enabling push notifications for self-hosted servers

These instructions do not apply to Zulip Cloud organizations (*.zulipchat.com).

To enable push notifications for your organization:

  1. Your server administrator needs to register your Zulip server with the Zulip Mobile Push Notification Service.

  2. For organizations with more than 10 users, an owner or billing administrator needs to sign up for a plan for your organization.