Offline events
Queue mobile events offline and flush them with original timestamps.
Last updated June 3, 2026
Configure offline queueing so mobile events are stored locally and flushed with original timestamps.
Prerequisites
- A mobile SDK installed
- Local storage available
- Network access when the app comes back online
Steps
Enable queueing
Keep offline queueing enabled in mobile SDK config.
config
1offlineQueue: {2enabled: true,3maxEvents: 10004}
Record event timestamps
The SDK stores when the event happened, not when it was uploaded.
Flush on reconnect
Queued events send when the app returns online or foregrounds.
Options / Configuration
| Option | Type | Required | Description |
|---|---|---|---|
| enabled | boolean | ✓ | Stores events while offline |
| maxEvents | number | no | Caps queue size |
| flushInterval | number | no | Flush cadence in seconds |
What happens next
Use Realtime to verify late arrivals show the original event time and delayed indicator.
Verify your setup
Verify your setup
Troubleshooting
Queued events never flush
Confirm local storage permissions and that the app foregrounds after network returns.
Was this page helpful?