Skip to content

Integration

ReachBell for WordPress

Install from the wp-admin Plugins screen, paste your project ID, and start collecting push subscribers on the next page view. WooCommerce abandoned-cart included.

ReachBell plugin versionactive installsWordPress.org rating

Install

Pick the path that matches how you ship — UI, CLI, or Composer.

# Option 1 — wp-admin > Plugins > Add New > search "ReachBell"
# Option 2 — WP-CLI
wp plugin install reachbell --activate

# Option 3 — Composer
composer require reachbell/wordpress

The settings page

After activation, head to Settings → ReachBell. The screen has four sections, stacked top-to-bottom, and every field has inline help text.

  1. Project & API key — paste the project ID from app.reachbell.com. The plugin verifies it live and confirms the connection with a green check.
  2. Prompt — pick from soft prompt, bell widget, or slide-in. Preview renders in the same panel so you can iterate without leaving wp-admin.
  3. Auto-push — toggle which post types and categories trigger a push on publish, plus quiet hours and a global daily cap.
  4. WooCommerce — turn on abandoned cart, order shipped, and review-request campaigns. Each one points to a template you can customize in the dashboard.

Custom hook: post-publish push

If you outgrow the settings UI, the plugin exposes a typed reachbell_send() helper from any theme or plugin file.

<?php
// wp-content/themes/your-theme/functions.php
// Optional: send a push when a post is published in a specific category.

add_action( 'transition_post_status', function ( $new, $old, $post ) {
    if ( $new !== 'publish' || $old === 'publish' ) return;
    if ( $post->post_type !== 'post' ) return;

    reachbell_send( [
        'channel'  => 'push',
        'segment'  => 'all-subscribers',
        'title'    => get_the_title( $post ),
        'body'     => wp_trim_words( $post->post_excerpt ?: $post->post_content, 22 ),
        'url'      => get_permalink( $post ),
        'image'    => get_the_post_thumbnail_url( $post, 'large' ),
        'utm'      => [ 'source' => 'wp', 'medium' => 'push', 'campaign' => 'new-post' ],
    ] );
}, 10, 3 );

What you get

The plugin is the WordPress side of ReachBell — push, WooCommerce automations, segments, and analytics, all wired up out of the box.

Settings page in wp-admin

A clean ReachBell screen under Settings — paste your project ID, pick a prompt style, and toggle which post types trigger push. No FTP, no code edits.

Post-publish push (with safelist)

Auto-push on publish for the categories or post types you choose. Drafts, scheduled posts, and quick-edits are excluded by default so you never accidentally spam.

WooCommerce abandoned cart

Bundled WooCommerce add-on detects carts abandoned after 30 minutes, sends a personalized push, and falls back to email if the subscriber is offline.

Gutenberg block: opt-in CTA

Drop the ReachBell block into any post or page — preview-mode-safe, themable, and tracks click-through into the campaign reports.

Segments, A/B tests, automations

Tags from your wp_users and WooCommerce customer fields sync straight into ReachBell as subscriber attributes, so segment rules just work.

GDPR-friendly out of the box

A preference center shortcode renders a one-click manage-channels page. Consent events flow into the ReachBell audit log automatically.

Looking for the full setup guide?

Settings walk-through, WooCommerce templates, and troubleshooting all live at docs.reachbell.com/integrations/wordpress.

FAQ

Questions, answered.

Everything teams usually ask before switching. Something missing? Email us — a human replies.

Which WordPress versions are supported?

WordPress 6.0 and newer, PHP 7.4 and newer. The plugin uses the Plugin API (hooks/filters) and the REST API — no custom DB tables, no schema migrations, easy to uninstall.

Does it work with caching plugins like WP Rocket or LiteSpeed Cache?

Yes. The prompt script is enqueued with defer and a versioned src — page caches keep working, and the prompt still renders on cached pages.

How do I trigger a campaign from a custom plugin?

Call reachbell_send() (PHP) or fire the rb:track JavaScript event. Both are documented in the plugin readme with hookable filters for every payload field.

Where does the service worker live?

The plugin copies reachbell-sw.js to your WordPress root on activation and registers it under your site origin — required by the Push API for first-party delivery.

Install in two clicks.

Free for your first 1,000 subscribers. No credit card.

Ready to make some noise?

Free forever for your first 1,000 subscribers. Set up in five minutes — no credit card needed.

Start free today