For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sending Notifications from the Post Editor

How to send a push notification when you publish a WordPress post, and how to control who receives it

Once the plugin is configured, a Pushly panel appears in the post editor sidebar. From there you can send a push notification for the post you are publishing, change the notification's wording, and choose which subscribers receive it.

The panel only appears when Send Notifications for New Posts is enabled on the Pushly settings page and the post type you are editing is listed under Enabled Post Types. See Installation & Setup.

Send Notification

Check Send Notification to create a push notification when the post is published. Everything else in the panel is disabled until this box is checked.

If Automatic Sending is enabled in the plugin settings, this box is checked for you on every new post, and you uncheck it for posts that should not notify.

A post sends at most one notification. Once it has sent, the panel is replaced by a notice showing the notification ID, and editing or re-publishing the post will not send another.

Customize Content

By default the notification uses the post title as its title and sends no body text. The landing URL is always the post's permalink, and the featured image, tags, and categories are carried across automatically.

Check Customize Content to override the wording:

  • Title — replaces the post title in the notification.

  • Body — optional supporting line beneath the title.

Leaving Customize Content unchecked is the common case and needs no attention.

Refine Audience

By default a notification goes to all subscribers. Check Refine Audience to narrow that, using two independent fields:

  • Targeted Segments — who receives the notification. Leave it empty to reach all subscribers.

  • Excluded Segments — who is held back from it. Leave it empty to exclude nobody.

Each field shows its empty behavior as placeholder text, so you can confirm the audience at a glance without sending anything.

Excluding without targeting is the way to say "send this to everyone except…" — for example, promoting a subscription offer to every reader who is not already paying.

Both fields draw from the segments configured on your Pushly domain. Start typing to filter, or click the field to see the full list. If your domain has no segments yet, the Refine Audience option does not appear at all.

Segment exclusion requires plugin version 2.4.0 or later. Earlier versions offer targeting only.

When the Notification Sends

  • Publishing immediately sends the notification right away.

  • Scheduling the post for a future date creates a notification scheduled for that same time. The notification is created when you schedule the post, and delivers when the post goes live.

Classic Editor

In the classic editor the Pushly meta box offers Send Notification and Customize Content only. Audience controls are not available there — a notification sent from the classic editor goes to all subscribers.

To target or exclude segments, use the block editor, or build the notification in the Pushly platform instead.

Troubleshooting

If you publish a post with Send Notification checked and no notification appears in the Pushly platform, enable the Activity Log and publish again. It records each step of the send, including the exact error returned by the Pushly API.

Last updated