Skip to main content
Version: v5

Foreground Service

This plugin allows for android devices to continue running services in the background, using a foreground ongoing notification. This is targeted towards use with plugins such as 'cordova-geolocation' that will not run while the app is in the background on android API 26+.

For android API 28+, the following xml snippet should be inserted into config.xml:

<platform name="android">
<config-file parent="/*" target="AndroidManifest.xml">
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

Stuck on a Cordova issue?

Don't waste precious time on plugin issues.

If you're building a serious project, you can't afford to spend hours troubleshooting. Ionic’s experts offer premium advisory services for both community plugins and premier plugins.


$ npm install cordova-plugin-foreground-service 
$ npm install @awesome-cordova-plugins/foreground-service
$ ionic cap sync

Supported Platforms

  • Android



Learn more about using Ionic Native components in React


import { ForegroundService } from '@awesome-cordova-plugins/foreground-service/ngx';

constructor(public foregroundService: ForegroundService) { }


startService() {
// Notification importance is optional, the default is 1 - Low (no sound or vibration)
this.foregroundService.start('GPS Running', 'Background Service', 'drawable/fsicon');

stopService() {
// Disable the foreground service