This plugin allows your application to receive push notifications, using the AeroGear UnifiedPush Server.

Usage no npm install needed!

<script type="module">
  import aerogearCordovaPush from '';


AeroGear PushPlugin Cordova

npm package

Dependency Status Known Vulnerabilities

This plugin makes starting with AeroGear Unified Push simple.

Project Info
License: Apache License, Version 2.0
Build: Cordova Plugin
Issue tracker:
Mailing lists: aerogear-users (subscribe)
aerogear-dev (subscribe)

Getting Started

Run tests

  1. Use your existing cordova app, or create a new one.
  2. Add the plugin and the tests:
cordova plugin add
cordova plugin add
  1. Add this plugin:
cordova plugin add
  1. Change the start page in config.xml with <content src="cdvtests/index.html" /> or navigate to cdvtests/index.html from within your app.


For more details about the current release, please consult our documentation.

Android notification icon

To show a better notification icon in Android Lollipop and above, create a transparent icon and name the file as "icon_white.png" and put into platforms/android/res/drawable folder.

Configuring Firebase Version

Many other plugins require Google Play Services and/or Firebase libraries. This is a common source of Android build-failures, since the library version must be aligned to the same version for all plugins. Use the FIREBASE_VERSION to align the required firebase-messaging version with other plugins.

For example:

cordova plugin add aerogear-cordova-push --variable FIREBASE_VERSION=11.8.0


If you would like to help develop AeroGear you can join our developer's mailing list, join #aerogear on Freenode, or shout at us on Twitter @aerogears.

Also takes some time and skim the contributor guide


Join our user mailing list for any questions or help! We really hope you enjoy app development with AeroGear!

Found a bug?

If you found a bug please create a ticket for us on Jira with some steps to reproduce it.