Up to 74% OFF Black Friday Deals
0Days
00Hrs
00Min
00Sec
Get the deal →
Documentation

Everything Appushy does.

Step by step, grounded in exactly what the plugin does today.

On this page Getting Started Connecting Web Push & Appilix Sending a Notification Push Automation Your Audience Customer Identification Notification Logs & Retries Troubleshooting & FAQ Pro Features & License

Appushy turns the events your site already has — orders, enrollments, messages, new posts — into push notifications, with built-in Web Push and optional Appilix app delivery. These guides cover every screen and setting, free and Pro alike.

Getting started

Install, connect your channels, and send your first push.

Automation & audience

Automatic events, who's subscribed, and identity matching.

Logs, help & Pro

Delivery logs, common problems, and what Pro adds.

How to install and set up Appushy

FREE
Install Appushy like any WordPress plugin, then use the setup wizard to turn on Web Push and/or connect Appilix — or skip it and set things up later from Appushy → Platforms.

Install the plugin

Install and activate Appushy the way you would any other WordPress plugin — from Plugins → Add New, or by uploading the zip file, then clicking Activate.

Run the setup wizard

Right after activation, a short setup wizard walks you through turning on Web Push (works immediately, nothing to sign up for) and/or connecting an Appilix app, if you have one. Pick either, both, or skip the wizard entirely and set things up later from Appushy → Platforms.

Appushy setup wizard, highlighting the Web Push and Appilix platform choice

Automatic integrations

Appushy also detects WooCommerce, Tutor LMS, and Better Messages automatically — each integration's notifications only turn on once that plugin is active. None of them are required just to install Appushy; new-post notifications work on any WordPress site with no other plugin at all.

How to connect Web Push and Appilix

FREE
Appushy → Platforms is where every channel lives. Turn on Web Push, Appilix, or both — a single send or automation reaches everyone connected at once.
Platforms screen showing Web Push and Appilix both Connected, with a Firebase Cloud Messaging card marked Coming soon

Web Push — nothing to set up

Toggle it on and it works. Appushy generates its own encryption keys and installs the small background file browsers need to deliver notifications when your site isn't open — all automatically, on your own server. No account, no third-party service, no API key.

Click Configure any time to see your keys and the background worker's address — useful only if something stops working and you want to check what's there.

Web Push Configure panel showing the automatically generated encryption keys and background worker address

Appilix — needs three things first

Appilix reaches your native Android/iOS app instead of a browser. Get these right on the Appilix side before connecting — skipping them won't break anything, but test pushes simply won't arrive until they're done:

  1. A paid Appilix plan. The Push Notification API isn't included on Appilix's free trial.
  2. Firebase connected to your Appilix app. In your Appilix dashboard: create a Firebase project, add your app to it, enable Cloud Messaging, then upload the Firebase config file Appilix asks for.
  3. Rebuild and reinstall your app. Firebase configuration is baked into the app binary at build time — a device with an older install won't receive anything until you rebuild and reinstall.

Once that's done, go to Appushy → Platforms → Appilix → Configure and paste your App Key and API Key, both from your Appilix dashboard's Push Notification API panel. Save, then use the same panel's test field to confirm a push actually reaches a device.

Appilix Configure panel with the App Key, API Key, and test fields
Appilix only learns about a device once someone opens the app and signs in from inside it — signing into your site in a regular browser doesn't register anything.

How to send a notification by hand

FREE
Go to Appushy → Send to write a notification, preview it on desktop and mobile, then choose who receives it and where it goes.

Compose the notification

Go to Appushy → Send. Write a title and message, see exactly how it'll look on desktop, Android, and iPhone before you send, then choose who gets it and where it goes.

Send screen with a title and message typed in, and a live preview of the notification

Choose the audience and channels

Under Who receives it, send to everyone subscribed, or — on Pro — a saved segment. Under Where it goes, uncheck any connected channel to skip it just for this send.

Who receives it section with Everyone selected and A segment available as an option

Three ways to send

Send a test to me (just your own device), Send now (goes out immediately), or Schedule for later (pick a date and time, optionally repeating).

How to turn on automatic push notifications

FREE
Appushy → Push Automation lists every notification your site can send, free and Pro alike, each with its own on/off toggle.

Every event, in one place

Go to Appushy → Push Automation to see and toggle every notification each connected integration can send.

IntegrationEventFree / ProNotes
WordPress PostsNew post, page, product, or course publishedFreeWorks on any WordPress site, no other plugin needed. Choose which content types notify in this panel.
WooCommercePending payment, Processing, On Hold, Completed, Cancelled, Refunded, FailedFreeAll 7 statuses, no send caps.
Tutor LMSEnrollmentFreeSent automatically when a student enrols in a course.
Tutor LMSCompletion, Assignment graded, Course access expiredProVisible with a padlock on the free plugin, with a sample preview you can try before upgrading.
Better MessagesDirect messageFreeSent when someone gets a new unread direct message.
Better MessagesGroup conversation, chat room, @mentionProDirect messages stay free either way.
Push Automation screen showing WooCommerce notification events with their Enabled toggles

Edit any event's text

Every event's text is editable — click Edit on any row to change the title and message, insert variables like the customer's name, and preview the result before saving.

Editing a notification's title and message, with variable buttons and a live preview

New-post broadcasts

New-post notifications get their own panel: pick which content types should notify, and optionally limit a send to one segment of your Web Push subscribers.

WordPress Posts panel with content type selector and segment-limiting option

How to see who's subscribed

FREE
Appushy → Audience lists everyone opted in to Web Push — searchable and exportable, with no subscriber limit on any plan.

See who's subscribed

Appushy → Audience lists everyone who's opted in to Web Push on your site — searchable, exportable, with a breakdown of which browsers and devices they're using. There's no subscriber limit on any plan.

Audience screen showing total subscriber stats and a browser/device breakdown

Appilix is separate

Appilix devices aren't listed here — Appilix keeps its own device list on its side, since it matches by identity rather than a subscriber record Appushy stores.

How to get Appilix notifications to reach the right customer

FREE
Appilix matches a push to a customer by identity — email or WordPress user ID — not a store record directly. Choose which one under Appushy → Settings.

Choose how Appushy matches identity

This section only applies to Appilix — Web Push subscribers don't need any identity matching, they're tracked automatically. Appilix delivers a push by matching an identity — an email address or a WordPress user ID — not a customer record in your store directly. Choose which one under Appushy → Settings → Identify customers by:

  • Email (default) — matches by the customer's email address, including the billing email on a guest checkout.
  • User ID — matches by WordPress user ID instead, keeping email addresses off Appilix's servers entirely, but only works for signed-in, registered customers.
A customer has to open your app and sign in from inside the app itself at least once before a push can reach them — the single most common reason an Appilix push doesn't arrive.
Settings screen showing the Identify customers by field set to Email

How to read your notification logs

FREE
Appushy → Logs shows every notification your site has sent, across every channel — filterable by status, trigger, platform, or recipient.

Read a log row's status

Each row shows a status:

  • Queued — accepted and handed off for delivery.
  • Not delivered — this customer hasn't opened your Appilix app yet. Normal, not an error.
  • Failed — something went wrong, with the reason shown in Notes.

Retries aren't duplicates

Seeing the same event more than once isn't a duplicate: Appilix sends retry automatically — 30 seconds later, then 2 minutes, then 5 minutes — before giving up, with each attempt logged as its own row.

Logs screen with filters and a table of notification rows showing status and notes

What "Queued" really means

Queued means Appushy successfully handed the notification off — confirmation of delivery to Appilix or to each browser's own push service, not confirmation a phone or screen actually displayed it. If something stays Queued but never visibly arrives, that's almost always a delivery issue on the Appilix/browser side, not something Appushy's own log can diagnose further.

How to fix common problems

FREE
Most delivery questions come down to one of these — check here before assuming something's broken.

Why isn't a subscriber or customer receiving notifications?

For Appilix, almost always because they haven't opened your app and been identified yet — the log shows "Not delivered — Hasn't opened your app yet" for these, the expected outcome, not an error. For Web Push, the usual cause is the subscriber's browser permission being revoked, or their device being offline for a long stretch — Appushy marks that subscriber Inactive automatically rather than retry forever.

Why do automatic notifications sometimes arrive a minute or so late?

That's WordPress's own background task scheduling (Action Scheduler), not Appushy — by default it only runs when someone visits your site, so a quiet site can see a short delay. For instant delivery regardless of traffic, set up a real server cron job: add define( 'DISABLE_WP_CRON', true ); to wp-config.php, then have your host run wp-cron.php on a real schedule. Manual sends aren't affected — those go out immediately.

Why are Better Messages push notifications delayed?

Better Messages only checks for unread messages on its own schedule — Notification Interval (Better Messages → Settings → Notifications, default 15 minutes, floor of 1 minute) plus Offline Delay on the same page. Appushy sends once Better Messages itself decides to fire, and can't speed that up.

Does Appilix work for guest checkouts?

Yes, when identifying by email (the default). Appushy registers the order's billing email with Appilix automatically on the order-confirmation page, whether or not the customer has an account.

Can I customize the notification text?

Every event has sensible default text with variables like the customer's name filled in automatically. Editing that text per event, and saving the edit so it's reused across sends, is a Pro feature.

Is my data safe?

Your Appilix App Key and API Key are never displayed after saving (masked in the UI) and never appear in the notification log. Web Push delivers directly from your server to each browser's own push service — never through any Appushy-operated server.

What Pro adds, and how to activate it

PRO
The free plugin has no caps, ever. Appushy Pro adds targeting, scheduling and per-channel control on top of it.

What Pro unlocks

The free plugin is a complete, unlimited tool on its own — no subscriber caps, no send-rate limits, no channel-count limits, ever. Appushy Pro adds:

  • Audience segmentation — target a send by role, device, browser, or page visited, instead of sending to everyone. Build a segment from Appushy → Segments.
  • Scheduling and recurring sends — schedule a send for later, or have it repeat automatically.
  • Per-channel content variants — different title, message, and link per channel from one send.
  • Reusable notification text — edit a trigger's default text and have it reused across sends.
  • Full Tutor LMS and Better Messages event coverage — completion, assignment graded, course-access-expired, group conversations, chat rooms, and @mentions, on top of the free events.
  • Priority support.
Segment builder with a Device condition set to Windows and Android, showing 2 matching subscribers Schedule for later dialog with a send date and Weekly repeat selected Where it goes section with Write different text for each platform checked, showing separate Web Push text

See Pricing to purchase a plan.

How to add your license

Once you've purchased, log into your Appushy account to find everything you need:

  • A Download Pro button for the appushy-pro plugin zip file.
  • Your Activation Email and Activation License Code — the two values the plugin asks for.
  • Your plan's site limit and a Manage Domains control, if you need to move the license from one site to another.
Appushy Pro's License screen with the Purchase email and License code fields and the Activate button
  1. Install and activate the downloaded appushy-pro zip the same way you would any WordPress plugin.
  2. Go to Appushy → License.
  3. Enter the Purchase email and License code from your account dashboard, then click Activate.

Once active, the same screen shows your plan and a Deactivate button — use that if you ever need to free up a site slot before activating the license somewhere else.

Appushy Pro's License screen showing Active status and a Deactivate button