Product FAQ
Push limit terminology
For JPush limit details, see Push terminology.
What are the core compliance requirements when using JPush?
To protect user privacy and data security, we recommend that developers prioritize non-sensitive, non-private routine messages (such as maintenance announcements, version upgrades, and activity notifications). These messages can be delivered directly through the push channel, and the platform provides end-to-end compliance support.
Can sensitive messages use the push service? What should I note?
Sensitive messages involving user privacy or business confidentiality (such as account information, real-name data, and private conversations) must not be pushed without encryption.
If push is required, developers must implement full end-to-end encryption on their own, manage encryption keys and decryption independently, and mitigate security risks before connecting to the push channel.
What is Registration ID?
After the client initializes JPush successfully, the JPush server assigns a Registration ID as the identifier for that device (Registration IDs differ for different apps on the same phone). For details, see Android Get RegistrationID API and iOS Get RegistrationID API.
What is the difference between notifications and custom messages?
Notification
- A notification is a message displayed in the phone notification bar (status bar).
- It is mainly used to alert users and applies to news, promotions, product information, version update reminders, order status reminders, and more. Adding notification capability helps improve app engagement.
Custom message
- A custom message is not a notification. By default, the SDK does not display it in the notification bar; JPush only passes it through to the SDK. Content and presentation are fully defined by the developer.
- Custom messages are mainly used for in-app business logic and special display requirements.
How do I view server-side push records?
- The push record page supports switching tabs to view push records for notifications, custom messages, in-app messages, Live Activity messages, and A/B tests.
- Server-side push records can be filtered by push method: API.
What do push statistics and loss reasons mean?
Is there a message length limit?
- On Android, the combined length of Notification + Message is limited to 4000 bytes.
- On iOS, the total length of
"ios":{ }and its contents must not exceed 2000 bytes (including custom parameters and symbols). The Message portion must not exceed 4000 bytes.
How much battery and data does the push SDK consume?
Measured battery and data usage depend heavily on network conditions. Excluding push payload content, theoretical averages are approximately 20 KB/day data and 30 mAh/day battery.
What is the difference between JPush free and VIP users?
Free users receive basic push services, cannot use tags, and have limits on vendor channel push.
VIP users get faster push speed and higher push frequency. For more VIP features, see the JPush pricing page.
App is on the blacklist; messages cannot be sent
This error means the app is not yet listed on the Xiaomi App Market. Xiaomi requires apps to be listed before messages can be delivered via the Xiaomi channel. For vendor listing instructions, see Vendor channel parameter application guide.
News/marketing message frequency limits and per-app per-device caps
Vendors classify messages by category. The default is operational messages (no sound or popup). A single device can receive only 2–5 operational messages per day. We recommend following the vendor message category guide to improve notification display rates.
Push service is stopped
This error means stopPush was called to stop the push service. Call resumePush to restore it. See the SDK API documentation.
