Complete setup and migration guide for OneSignal WordPress Web Push Plugin v3+. Configure push notifications, prompts, and segmentation through the OneSignal dashboard with streamlined setup process.
Select WordPress from the Website Builder options in your OneSignal dashboard
256x256px
PNG or JPG file for notifications and prompts – MacOS Safari will not show a notification prompt without an Icon.Enter your exact Site URL. https://your-site.com is different from https://www.your-site.com—use only one format consistently
Click on Push Slide Prompt to customize
Access and customize your push slide prompt settings
Configure timing and text:
1
pageview and 1
second for initial testing
Configure auto-prompt timing and customize prompt appearance
Click Done when you've finished configuring the prompt.
Copy your App ID and API Key from the OneSignal dashboard
In your WordPress admin, navigate to the OneSignal plugin settings
Paste the App ID and REST API Key exactly as shown in your dashboard
Ensure your WordPress plugin App ID and REST API Key match your OneSignal dashboard exactly
Advanced settings for enhanced functionality and analytics tracking
After saving your OneSignal dashboard configuration, return to WordPress
Click Migration Completed in the plugin settings
Click Save Settings to finalize the upgrade
Click Migration Completed to finalize your plugin upgrade
Your configured slidedown prompt should appear based on your timing settings
Browser permission prompt (appearance varies by browser) is required for web push notifications
Welcome notification appears immediately after successful subscription
OneSignal Push Notifications metabox—drag to reposition if needed
news
is 1
deals
is 1
Tags are case-sensitive! 'news' and 'News' are different tags
Select specific segments to target relevant user groups
Customize notification title, content, and other elements
Customized push notification as it appears to users
How do I disable prompts on specific pages?
Disable Auto Prompt to manually control when prompts appear
Can I send notifications to mobile app subscribers?
How do I send email or SMS from WordPress?
Why aren't my prompts working after migration?
Disable browser cache to force loading updated files after migration
What does `A bad HTTP response code (404)` error mean?
404 error in browser console indicates incomplete migration process