Need help upgrading to Ionic Framework 4.0? Get assistance with our Enterprise Migration Services EXPLORE NOW

Phonegap Local Notification

Improve this doc

The Local Notification plugin gives developers the ability to post notifications from their app that show up in the device’s notification area. The API for the local notification plugin follows the W3C Web Notifications specification:



  1. Install the Cordova and Ionic Native plugins:
    $ ionic cordova plugin add phonegap-plugin-local-notification
    $ npm install --save @ionic-native/phonegap-local-notification@4
  2. Add this plugin to your app's module

Supported platforms


import { PhonegapLocalNotification } from '@ionic-native/phonegap-local-notification';

constructor(private localNotification: PhonegapLocalNotification) { }


  (permission) => {
    if (permission === 'granted') {

      // Create the notification
      this.localNotification.create('My Title', {
        tag: 'message1',
        body: 'My body',
        icon: 'assets/icon/favicon.ico'


Instance Members

create(title, Options)

A global object that lets you interact with the Notification API.

Param Type Details
title string

Title of the local notification.

Options LocalNotificationOptions

An object containing optional property/value pairs.

Returns: PLNObject


requests permission from the user to show a local notification.

Returns: Promise<any>


Param Type Details
dir string

Sets the direction of the notification. One of "auto", "ltr" or "rtl"

lang string

Sets the language of the notification

body string

Sets the body of the notification

tag string

Sets the identifying tag of the notification

icon string

Sets the icon of the notification