PushAI user and developer documentation.

Add the subscribe button to a page

Outcome: Visitors can click one button and allow browser notifications.

1. 1Open the WordPress page or post where you want the button to appear.
2. 2Paste [pushai_button] into the content editor, shortcode block, widget, or template.
3. 3Optional: customize it with label, on, blocked, align, and class attributes.
4. 4Update the page, open it in a supported browser, and click the button.
5. 5Accept the browser permission prompt. The browser should appear under PushAI -> Subscribers.

[pushai_button label="Enable browser notifications" align="center"]

Send your first test notification

Outcome: Confirms that subscription collection, VAPID credentials, and delivery queue all work.

1. 1Subscribe from the front end first. Use the same browser you will use for testing.
2. 2Go to PushAI -> Notifications.
3. 3Create a manual notification with a short title, message, and destination URL.
4. 4Send it to all subscribers, or select your WordPress user if you are testing a targeted send.
5. 5Open PushAI -> Dashboard and check Recent notifications, Queue depth, and Failed jobs.

Automatically notify subscribers when a post is published

Outcome: PushAI queues a notification whenever a post is published.

1. 1Go to PushAI -> Settings.
2. 2Enable Push service.
3. 3Enable New post automation.
4. 4Publish a new post. Existing already-published posts will not re-trigger unless republished through a new transition.
5. 5Check PushAI -> Notifications to confirm that a new campaign was created.

Allow visitors without accounts to subscribe

Outcome: Logged-out readers can become browser subscribers.

1. 1Go to PushAI -> Settings.
2. 2Enable Guest subscriptions.
3. 3Place [pushai_button] somewhere public on the site.
4. 4Test in an incognito/private window.
5. 5Confirm the new row appears in PushAI -> Subscribers under Guests.

Send to selected WordPress users only

Outcome: A notification reaches only users with active browser subscriptions.

1. 1Ask the target users to log in and subscribe from their browsers.
2. 2Go to PushAI -> Notifications.
3. 3Create a manual notification and search/select the recipients.
4. 4Send the notification.
5. 5If a selected user has no active subscription, PushAI skips that target by default.

Change the notification icon

Outcome: Notifications show a recognizable site or brand icon.

1. 1Prepare a square PNG image. 192x192px or larger is recommended.
2. 2Go to PushAI -> Settings.
3. 3Use Notification icon -> Select image.
4. 4Save settings.
5. 5Send a test notification. Some browsers may cache old icons briefly.

Activate PushAI Pro

Outcome: Unlocks Pro menus and licensed automation.

1. 1Install and activate the main PushAI plugin first.
2. 2Install and activate PushAI Pro.
3. 3Go to PushAI -> Plans & License.
4. 4Paste or confirm the license key and activate it for this site.
5. 5Reload the PushAI menu. AI Digests, Statistics, Templates, and Pro settings become available.

Set up scheduled AI digests

Outcome: Recent posts are collected and sent as scheduled browser push summaries.

1. 1Go to PushAI -> AI Digests.
2. 2Enable AI digest service.
3. 3Set Delivery times using the WordPress site timezone, for example 09:00,18:00.
4. 4Choose Lookback window, Minimum posts, Maximum posts, and Digest language.
5. 5Optionally add an OpenAI API key and model. Without a key, PushAI uses a template fallback.
6. 6Save AI settings and watch Recent AI Digest Summaries after the next scheduled run.

Enable notifications for custom post types

Outcome: Publishing selected content types can trigger automatic browser notifications.

1. 1Go to PushAI -> Settings with Pro active.
2. 2Find Automatic notification post types.
3. 3Select the public post types you want to notify for.
4. 4Add comma-separated custom post type slugs if a type does not appear in the checkbox list.
5. 5Save settings and publish a new item in that post type.

Notify authors about new comments

Outcome: Post authors receive browser notifications when their content gets comments.

1. 1Go to PushAI -> Settings.
2. 2Enable Comment notifications.
3. 3Enable Notify post author.
4. 4Select the post types that should trigger comment notifications.
5. 5Make sure authors are logged in and subscribed to browser notifications.

Turn on WooCommerce order and stock alerts

Outcome: Subscribed administrators and registered customers receive store events by push.

1. 1Make sure WooCommerce is active before configuring this section.
2. 2Go to PushAI -> Settings and find WooCommerce.
3. 3Enable WooCommerce notifications.
4. 4Enable the exact events you need: admin orders, admin stock, customer order status, customer order notes, or customer cross-sell.
5. 5For cross-sell, set Delay after order and Max suggested products.
6. 6Remember: customer notifications only reach registered, subscribed customers. Guest checkouts cannot be targeted.

Customize automatic notification text

Outcome: Automatic notifications use your own titles and message templates.

1. 1Go to PushAI -> Templates.
2. 2Edit the template for the event you want: new content, comments, trending, admin alerts, or WooCommerce.
3. 3Use placeholders such as {title}, {excerpt}, {post_title}, {comment_author}, {order_number}, or {product_names}.
4. 4Leave a field blank to fall back to the plugin default.
5. 5Save templates and trigger the event again to test the output.