Push Notifications sends browser notifications to visitors who agree to receive them, for example when you publish a post. By default your own site sends them with Web Push: there is no account or notification service to sign up for, and the subscribers are kept on your site. A subscription belongs to a browser, not to a person or an account.
Where to find it: in Vendix Pro, turn it on in ARN Vendix → Smart Features → Push Notifications and set it up in ARN Vendix → Push, with the tabs Settings, Campaigns and Subscribers. In Vendix Free, everything is in ARN Utilities → Smart Features → Push Notifications. Push Notifications is in Vendix Free and Pro from version 3.0.0, is off by default and needs HTTPS. Its settings need the permission to manage options.
Free and Pro
| Feature | Vendix Free | Vendix Pro |
|---|---|---|
| Delivery | Your site (Web Push) | Your site (Web Push), OneSignal or Firebase Cloud Messaging |
| Subscribe box (corner card or top bar) with timing and page rules | Yes | Yes, with Vendix display rules, devices and groups |
| New post notifications | Yes | Yes, also to the readers of its groups and followed topics |
| Breaking news, followed topics, live coverage | No | Yes |
| Price drop, back in stock, order updates | No | Yes |
| Campaigns with history and counts | No (the last 10 notifications are listed) | Yes |
Bell, ARN Push Button widget, [arnvx_push_button] | No | Yes |
| Quiet hours, daily limit, UTM tags | No | Yes |
| Test to your own browsers, web app manifest for iPhone and iPad | Yes | Yes |
When you move from Vendix Free to Vendix Pro, the subscribers and the site keys move too, so nobody has to subscribe again.
Turn on Push Notifications
- In Vendix Pro, open ARN Vendix → Smart Features → Push Notifications, turn on Enable Push Notifications, save and click Open ARN Vendix → Push. In Vendix Free, turn it on in ARN Utilities → Smart Features → Push Notifications.
- Check the Status box: it shows whether the site is ready, how background jobs run and where the service worker answers. Click Check setup. A page cache that ignores query strings can break the service worker address; leave that address out of the page cache if the check fails.
- Click Subscribe this browser, then Send a test to my browsers. The test arrives within a minute and goes only to the browsers you subscribed while signed in as yourself.
- Set up the subscribe box and the notifications (see below) and save.
While Push Notifications is off, nothing of it loads on your pages: no script, no service worker address and no box.
Choose the delivery (Pro)
Under Settings → Delivery, Send notifications through:
- Your site (Web Push), the default: no account is needed, and subscribers are kept on this site. The Site key (VAPID) ties every subscription to your site. Do not reset it: Reset keys… removes every subscriber. Contact for push services is your site address or a mailto: address; it is sent with each notification.
- OneSignal: enter the App ID and the REST API key. OneSignal keeps the subscribers, and after a visitor clicks "Allow" the browser loads the OneSignal Web SDK.
- Firebase Cloud Messaging: paste the Web app config (JSON), the Web push certificate key (public) and the Service account (JSON).
Secret keys are stored separately and never shown again; type a new value to replace one.
Set up the subscribe box
| Setting | What it does | Default |
|---|---|---|
| Layout | Corner card or Top bar | Corner card |
| Texts | Title, text and button labels; empty fields use the default texts in each visitor's language | Default texts |
| When to show | After a number of seconds, from a page number a visitor sees, after scrolling a share of the page | After 8 seconds, from page 2, no scrolling needed |
| Where to show | Pro: Show on and Never on with the display rules of Banners and Templates, and Devices. Free: All pages, Posts only, Posts and pages or Only these pages, and Never on these pages | Everywhere, all devices |
| After "Not now" | Days the box stays away | 7 days |
| Groups (Pro) | Up to 20 topic groups, each with its categories; Chosen in the box lets visitors pick them | None |
| Bell button (Pro) | Bell button (subscribe, choose groups, turn off) | Off |
The box asks in two steps: the browser's own permission question comes only after the visitor clicks your button. Cart, checkout and account pages never show the box. In Pro, the ARN Push Button widget and the [arnvx_push_button] shortcode (with optional label and label_on) place a button on any page; a subscriber turns notifications off with the same button.
Choose what sends a notification
New posts. Send a notification when a post is published is on by default, and Tick "Send to subscribers" on new posts by default ticks the box on new posts. On the post screen, the Push notification box has Send to subscribers when published, an optional title (empty: the post title) and text (empty: the excerpt). The notification goes out one minute after publishing. In Pro, choose the Post types and Send to: Every subscriber (the default) or Readers of its groups and followed topics.
The other triggers are Pro and on by default:
| Trigger | What it sends |
|---|---|
| Breaking news | Breaking news (high priority) on the post screen: to everyone, high priority, expires after 1 hour; Keep on screen until clicked is optional |
| Followed topics | New stories of followed categories, tags and authors |
| Live coverage | A "Live now" notification when coverage starts; Allow notifications for single entries lets editors notify about an entry |
| Store | Price drop and back in stock for visitors who asked in those boxes, order status changes (processing, completed, cancelled and refunded by default) and Shipped (with the tracking link) for customers who chose Get order updates in this browser on the Order received page |
Send a campaign (Pro)
- Open ARN Vendix → Push → Campaigns and fill in New campaign: Title (at most 80 characters), Message (at most 180), Link (an address of this site or an https:// address; empty: the front page) and an optional Image (large in Chrome and Edge).
- Choose the Audience: all subscribers, Groups, or Followers of these categories, and the Language. With all languages, each language gets its own text.
- Under Send, choose Now or Schedule with a date and time. Under Advanced, set the Priority, Expires after (1 hour to 4 weeks) and Keep on screen until clicked.
- Send it. A scheduled campaign can be cancelled until it goes out.
History lists every notification with its type, audience, sent time, Targeted, Delivered, Removed and Clicks counts and status.
Quiet hours, limits and subscribers (Pro)
| Setting | What it does | Default |
|---|---|---|
| Quiet hours and limit | Holds automatic notifications between two times (site time) and sets at most N automatic notifications a day (up to 100); empty times and 0 turn them off | Off |
| Links | Add UTM tags (utm_source=push); links with query strings can skip your page cache | Off |
| Keep subscriptions | Removes subscriptions after this many days without a visit; subscriptions the push services report as expired are removed at once | 365 days |
Breaking news, order updates and tests are never held by quiet hours or the daily limit. The Subscribers tab shows the number of subscribers, new and removed ones in the last 7 days, and counts by browser, language and group. There is no list of people, and no IP address or browser details are kept.
iPhone and iPad
Push notifications work on iOS and iPadOS 16.4 or later, once the visitor adds the site to the Home Screen and opens it from there. The subscribe box shows these steps to iPhone and iPad visitors. For this, Vendix adds a web app manifest with your site's name, Site Icon and colours (Add a web app manifest for iPhone and iPad, on by default), unless a PWA plugin already prints one.
Limits and good to know
- Each browser picks its own push service (for example Firebase Cloud Messaging for Chrome or the Mozilla Push Service for Firefox); each notification is encrypted for that browser only.
- Notifications go out in the background. With more than 5,000 subscribers on a site with few visits, a real server cron sends them on time.
- Without cURL in PHP, notifications go to the push services one by one, more slowly.
- Visitors decide in their browser whether they get notifications, and they can turn them off there at any time.