Overview
Push throttling in OneSignal allows you to control the rate at which push notifications are delivered to users. This is particularly useful for managing server capacity and ensuring a smooth user experience during high-volume sends.Benefits
- Manage server load – Prevent overload by distributing message delivery over time.
- Preserve performance – Avoid performance degradation during mass sends.
- Improve user experience – Maintain consistency and responsiveness across devices.
Configuration options
Throttling must be enabled at the global settings level to be available for use.Global throttling settings
Enable throttling for all push messages under Settings > Push & In-App > Throttling. Once enabled, this setting applies to all push notifications by default, but can be overridden for individual messages.
Navigate to Push Throttling Settings
Per-message throttling override
You can override global throttling settings on individual messages.- During notification creation, check the “Override throttling setting” box
- Set your desired messages-per-minute rate
- To disable throttling for a specific message, enter “0” in the messages-per-minute field
throttle_rate_per_minute
property.
Throttling must be enabled at the global settings level to be available for
any use.
How throttling works
Rate conversion process
OneSignal converts your per-minute setting to a per-second rate to optimize delivery:- The system divides your throttle rate by 60 (seconds per minute)
- The result is rounded down to the nearest whole number (OneSignal can’t send partial messages)
- This per-second rate is then applied throughout the delivery process
Throttling conversion example
- You set 1019 messages per minute
- Calculation 1019 ÷ 60 = 16.98 messages per second
- Rounded down 16 messages per second
- Actual delivery rate 16 × 60 = 960 messages per minute
- Difference 59 fewer messages per minute than the set rate
Limitations and Considerations
24-Hour Delivery Window
All throttled notifications must complete delivery within 24 hours of being sent. If your throttling rate would cause delivery to exceed 24 hours, OneSignal automatically adjusts the rate to ensure completion within this timeframe.Automatic throttling adjustment example
If you set a throttle rate of 10 messages per minute for 20,000 users (which
would take approximately 33 hours), OneSignal will automatically adjust the
rate to around 14 messages per minute to ensure delivery completes within the
required 24-hour window.
Compatibility with Other Features
Timezone and Intelligent Delivery
Throttling takes precedence over Timezone and Intelligent Delivery options. When throttling is enabled, these features will be ignored for that notification. To use Timezone or Intelligent Delivery:- Disable throttling for that specific notification under Delivery Schedule
- Set “Override throttling setting” to “0”
- For API notifications, set
throttle_rate_per_minute: 0
Journeys and Automated Messages
Throttling is not supported for:- Journeys
- Automated Messages
Notifications sent via Journeys or Automated Messages do not support
throttling. These messages are paced automatically based on user behavior and
do not require manual rate control.
Availability
Throttling is only available for:- Push notifications sent via the Create notification API
- Push notifications created through the Messages > New Push interface