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.

  1. During notification creation, check the “Override throttling setting” box
  2. Set your desired messages-per-minute rate
  3. To disable throttling for a specific message, enter “0” in the messages-per-minute field

For API-sent notifications, use the 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:

  1. The system divides your throttle rate by 60 (seconds per minute)
  2. The result is rounded down to the nearest whole number (OneSignal can’t send partial messages)
  3. 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

This conversion ensures more efficient processing by eliminating delays between batches.


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

These features send notifications dynamically as users enter segments or trigger events, which naturally spreads out delivery over time.

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