Awesome Cordova Plugins Docs

Community docs for every @awesome-cordova-plugins package — install guides, API notes and Capacitor migration paths.

badge

Badge plugin for Cordova and Ionic. The essential purpose of badge numbers is to enable an application to inform its users that it has something for them —…

latest: v9.6.0 · npm: @awesome-cordova-plugins/badge

Install

npm install @awesome-cordova-plugins/badge
ionic cordova plugin add cordova-plugin-badge

Migrating to Capacitor?

No 1:1 official equivalent was found for this plugin. Check the Capgo community plugin directory or the official Capacitor plugin list for alternatives — many Cordova plugins also still work inside Capacitor via npx cap add.

Badge

The essential purpose of badge numbers is to enable an application to inform its users that it has something for them — for example, unread messages — when the application isn’t running in the foreground.

Requires Cordova plugin: cordova-plugin-badge. For more info, please see the Badge plugin docs.

Android Note: Badges have historically only been a feature implemented by third party launchers and not visible unless one of those launchers was being used (E.G. Samsung or Nova Launcher) and if enabled by the user. As of Android 8 (Oreo), notification badges were introduced officially to reflect unread notifications. This plugin is unlikely to work as expected on devices running Android 8 or newer. Please see the local notifications plugin docs for more information on badge use with notifications.

Installation

ionic cordova plugin add cordova-plugin-badge
npm install @awesome-cordova-plugins/badge

Plugin Repo: https://github.com/katzer/cordova-plugin-badge

Supported Platforms

Further Information