Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For an Ionic app built with Capacitor, use OneSignal’s current Capacitor SDK—not its older Cordova-plugin instructions or a browser Web Push setup. OneSignal’s guide requires Capacitor 7 or later and covers native iOS and Android push. The core flow is to configure platform credentials, install and sync the plugin, initialize it with your OneSignal App ID, request permission at an appropriate time, and test a device subscription.

Choose the setup that matches your app

This guide is for an Ionic app that uses Capacitor to build native iOS or Android apps. Follow OneSignal’s Capacitor SDK setup; it lists Capacitor 7 or later as a requirement. If your app uses Cordova rather than Capacitor, use OneSignal’s separate Ionic/Cordova instructions instead.

Native push and browser Web Push are different integrations. The Capacitor plugin is for installed iOS and Android apps. Web Push uses the web SDK and browser-specific setup; Ionic’s 2021 Ionic React article describes that browser route, not the current native Capacitor flow.

Check prerequisites and configure OneSignal

OneSignal’s current guide lists the following environment requirements. Toolchain requirements can change, so check the live guide before beginning a new project.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Samsung Galaxy A17 5G Smart Phone 128GB US 1 Yr Manufacturer Warranty Black
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.
  • Capacitor: version 7 or later.
  • iOS: macOS with Xcode 14 or later; an iOS 15 or iPadOS 15 or later device, or an Xcode simulator running iOS 16.2 or later; and CocoaPods 1.16.2 or later.
  • Android: an Android 7.0 or later device or an emulator with Google Play services installed.

Create or open the OneSignal app for your project, then configure the platforms you plan to support. OneSignal lists Apple APNs, Google FCM, Huawei HMS, and Amazon ADM as platform options. For typical iOS and Android builds, configure the relevant Apple and Firebase credentials in OneSignal:

  • iOS: add an APNs authentication token (p8), which the guide recommends, or an APNs certificate (p12).
  • Android: add Firebase Cloud Messaging credentials.

Copy the OneSignal App ID from your OneSignal app. You will use it when initializing the SDK.

Rank #2
Tracfone Motorola Moto G 2025, 64GB, Saphire Blue (Locked to
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Tracfone plan required, activating is easy, just 3 steps.
  • DISPLAY: Immersive viewing on a 6.7-inch super-bright 120Hz display with powerful stereo speakers and Bass Boost for cinematic entertainment.
  • CAMERA SYSTEM: Advanced 50MP Quad Pixel camera captures sharp, detailed photos and videos in any lighting condition
  • PERFORMANCE: Lightning-fast 5G connectivity paired with a powerful processor and RAM Boost for smooth multitasking.
  • BATTERY LIFE: Long-lasting 5000mAh battery with TurboPower charging technology delivers hours of power in minutes.

Install and initialize the Capacitor plugin

From your Ionic project directory, install the package and sync the native projects:

npm install @onesignal/capacitor-plugin
npx cap sync

Initialize OneSignal with your App ID when the app starts. OneSignal’s current guide provides framework examples for Angular, React, and Vue; use the example that matches your Ionic app rather than copying an older web SDK snippet. In React, put initialization in the app-level startup lifecycle and prevent it from running more than once.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Samsung Galaxy A17 5G Smart Phone 128GB, US 1 Yr Manufacturer Warranty Blue
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.

The guide includes a direct permission request as part of its setup example. That is useful for testing, but an app should not necessarily show a system permission prompt immediately on launch. Ask when users understand the value of notifications; OneSignal recommends removing the immediate prompt after testing and using in-app messages to invite users to enable notifications.

Configure native iOS capabilities

Open the iOS workspace in Xcode and configure the app target. Add the Push Notifications capability. If your app needs background wake behavior, also add Background Modes and enable Remote notifications.

Rank #4
Samsung Galaxy S26 Ultra, Unlocked Android Smartphone, 512GB, Black
  • PRIVACY DISPLAY: Automatically hide your screen from those beside you. The built-in privacy display can be preset¹ to turn on when receiving notifications, typing passwords, or using specific apps
  • TYPE IT IN. TRANSFORM IT FAST: Enhance any shot in seconds on your smartphone by using Photo Assist² with Galaxy AI.³ Add objects, restore details, or apply new styles by simply typing or tapping
  • NIGHTS, CAPTURED CLEARLY: From gigs to city lights, record and capture moments after dark with clarity using Nightography so your photos and videos stay crisp and clear on your Samsung Galaxy
  • MAKE IT. EDIT IT. SHARE IT: Turn everyday moments into something personal with creative tools built right into your mobile phone, whether it’s a special contact photo, custom wallpaper, an invitation or more⁴
  • HELP THAT KEEPS UP: Stay in the moment while Now Nudge with Galaxy AI helps you respond faster and stay organized with smart suggestions⁵ that appear exactly when you need them on your phone

Some enhanced notification features require extra native configuration. OneSignal documents an App Group and a Notification Service Extension (NSE) for capabilities such as confirmed receipt, badges, and rich notifications. Configure the group for the relevant targets and add the OneSignal SDK to the extension target when using those features. These additions are not presented as prerequisites for every basic push notification; follow OneSignal’s current extension instructions for your project before adding target-specific settings.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Request permission and verify the subscription

Notification permission is controlled by the operating system. After the user accepts the prompt, check the subscription in OneSignal rather than assuming that calling the permission method alone means delivery is ready.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Tracfone Moto g Play 2024 Prepaid Phone with a 1-Yr Plan Included
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Activating is easy, just 3 steps.
  • ACTIVATION Promotion: Includes 1500 min, 1500 texts & 1500 MB Data + add more as you need it
  • CAMERA SYSTEM: 50MP Quad Pixel camera. Capture sharper, more vibrant photos day or night with 4x the light sensitivity.
  • PERFORMANCE: Blazing-fast Qualcomm performance. Get the speed you need for great entertainment with a Snapdragon 680 processor and 4GB of RAM.
  • 64GB built-in storage. Get plenty of room for photos, movies, songs, and apps. Made for US
  1. Run the app on a supported test device or emulator and trigger the permission request at the point you want to evaluate.
  2. In the OneSignal dashboard, open Audience > Users & subscriptions > Subscriptions. Before permission is accepted, the device may show as Never Subscribed.
  3. After accepting permission, refresh the subscriptions view and confirm that the device shows Subscribed.
  4. Add the subscription to Test Users, create a Test Users segment, and send a test notification to that segment from the dashboard or through the documented OneSignal API flow.

Keep OneSignal API keys on a server or in a secure environment; never embed an API key in client-side app code. The guide’s example API request is for a controlled command-line test, not a pattern for shipping a secret inside the app. When confirmed receipt is configured, check the message statistics in the dashboard for the corresponding receipt information.

Choose an Android test environment

A physical Android phone is not mandatory for the documented test path: OneSignal lists either an Android 7.0 or later device or an emulator with Google Play services. An emulator is convenient for initial verification; a physical device can additionally validate behavior on real hardware.

Keep older Ionic instructions separate

OneSignal’s Ionic and Capacitor Android tutorial, published September 2, 2021, uses the older onesignal-cordova-plugin workflow. Treat it as historical context, not as a replacement for the current Capacitor SDK guide. Likewise, do not mix browser Web Push service-worker steps with the native iOS and Android Capacitor integration.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.