Push Notifications
Send a quick push and inbox notification to selected customers or everyone, and learn which order updates customers receive automatically.
Push Notifications
The Push Notifications tab sends a one-off message to your customers right away. Storefront delivers it through Apple Push Notification service (APNs) on iOS and Firebase Cloud Messaging (FCM) on Android, and also adds it to each customer's notifications inbox.
For scheduled messages, segment targeting, images or deep links, use Campaigns instead.
Prerequisites
- Configure a notification channel in Storefront → Settings → Notifications. See Notification Settings.
- Your customer-facing app must ask for notification permission, obtain the device token, and register it with Storefront. The open-source Storefront App does this for you.
Sending a notification
Navigate to Storefront → Promotions and open the Push Notifications tab.
Enter the Notification Title and Notification Body.
Toggle Select All Customers to send to everyone, or leave it off and pick customers from the search.
Click Send Notification.
Each send is recorded as a campaign named Push notification: [title], so you can see it later in the Campaigns list along with how many customers it reached. Delivery runs on the queue, and customers who turned off promotional notifications are skipped.
Automatic order notifications
Storefront also notifies customers automatically as their order progresses — by push, in their inbox and by email — with no setup beyond a notification channel and a registered device:
| Notification | Sent when |
|---|---|
| Order accepted | The store accepts the order (or it is auto-accepted) |
| Ready for pickup | A pickup order is dispatched |
| Driver assigned | A driver is assigned |
| On the way | The driver starts the order |
| Nearby | The driver is close to the drop-off |
| Delivered | The order is completed |
Preparing and canceled notifications can be sent with the storefront:send-order-notification command. New orders alert the store's staff by email and SMS rather than the customer.
Customers can turn off order update pushes in their notification preferences; the inbox copy is always kept. To check that a channel can reach a device, use Send test in Notification Settings.