Overview

The Taboola Push Notification plugin enables you to send push notifications to your audience directly from your WordPress dashboard. Use it to notify subscribers about new content, breaking news, or scheduled campaigns.

Key features:

• Send manual push notifications immediately or schedule them for later
• Automatically send notifications when publishing posts
• Target specific apps and audience segments
• Customize notification titles, messages, and thumbnails
• Track notification status through the plugin dashboard

📘

Push API

The Taboola Push Notification plugin uses Taboola's Push API.

To obtain your API credentials, reach out to your Taboola Account Manager.

Install the plugin

In your WordPress dashboard:

1. In the sidebar (left), select Plugins > Add Plugin.

2. In the search box provided (top, right) type in "Taboola Push Notification":

   As you type, the system automatically filters for matching plugins.

3. Locate the Taboola Push Notification plugin and click on Install Now (top, right):

   

4. Once the installation has run, click on Activate (top, right). Then follow the instructions below to configure the plugin.

The plugin dashboard

1. In your WordPress dashboard, select Taboola Push Notification (left). The plugin dashboard displays:

   

The plugin dashboard has the following sections:

Status cards section:

• Push Notification Server: Shows the server connection status

  See: Configure API access below

• Plugin Status: Shows whether the plugin is active

Quick Actions section:

• Notification Settings: Configure API credentials and send manual notifications

  See: Configure API access below

• Manage Posts: View and edit your WordPress posts

  See Send notifications from posts below

• View Site: Preview your public website

How It Works section:

A 3-step guide showing the workflow:

1. Create or edit posts
2. Send notifications (manual or automatic)
3. Taboola Push Notification Server Integration

System Information section:

• Shows system information e.g. Plugin version, WordPress version, etc.

Configure API access

1. Under Quick Actions, click on Notification Settings.

2. If needed, expand the Taboola Push Notification Server Authentication section.
3. Enter your credentials:

   • Client ID: Your Taboola client identifier

   • Client Key: Your secret authentication key

     To reveal the key while entering it, check Show key.

     🚧

     Your Client Key is confidential - keep it secret.

     📘

     To obtain your API credentials, reach out to your Taboola Account Manager.

4. In the Default Notification Thumbnail section, enter a Default Thumbnail URL.

   The image URL must be publicly accessible and use https. Recommended image size: 192x192 pixels

5. Click Save Settings.

Send manual notifications

1. In your WordPress dashboard, select Taboola Push Notification (left).

2. Under Quick Actions, click on Notification Settings.

3. If needed, expand the Send Manual Notification section:

   

4. Configure targeting:

   • Send To App: Click 🔄 Refresh to load apps, then select an app

   • Segments (optional): Click to configure advanced targeting by country, language, browser, etc:

     

5. Enter notification content:

   • Notification Title (required, 140 characters max)
   • Notification Message (required, 500 characters max)
   • Target URL (required): Select Custom URL, 🏠 Homepage, or a recent post/page
   • Thumbnail URL (optional): Custom image URL, or leave empty for default

6. To send immediately, leave Schedule unchecked. To schedule, check Schedule and select a date/time.

7. Click Send Notification.

Send notifications from posts

1. Under Quick Actions, click on Manage Posts (or select Posts in the left sidebar).

2. Add a new post or edit an existing post.

3. Locate the Taboola Push Notifications meta box below the editor:

   

4. Configure targeting:

   • Send To App: Click 🔄 Refresh and select an app
   • Segments (optional): Configure advanced targeting

5. (Optional) Check Customize notification content to override the post title/excerpt.

6. (Optional) Check Schedule to set a future send time.

7. Publish the post. After publishing, click Send Notification.

📘

Automatic sending

If you configure notification settings before publishing (without scheduling), the notification sends automatically when you publish the post.

Troubleshooting

Push notifications not working

1. Verify HTTPS is enabled (required for production).
2. Check Client ID and Client Key in settings.
3. Confirm Enable Push Notifications is checked.
4. Verify Default Thumbnail URL is configured.
5. Check dashboard for 🟢 Connected status.

Authentication errors

1. Double-check Client ID and Client Key (no extra spaces).
2. Click Show key to verify the key is entered correctly.
3. Contact your Taboola account manager to verify credentials are active.

Apps not loading

1. Verify Client ID and Client Key are saved.
2. Click Save Settings before trying Refresh.
3. Contact your Taboola account manager to verify apps are configured.

What's next?

Well done! You have successfully configured the Taboola Push Notification plugin.

For developers who need to integrate push notifications programmatically, see the Push API documentation.