Background Modes property

Official Content
This documentation is valid for:
Specifies the background modes supported by the application


iOS imposes some limitations on the functionality that an application can use when running in the background unless the developer explicitly indicates the features required to run when the application is not active (e.g. audio playback, when the end user is executing another app or the device is blocked).

The Background Modes property allows the GeneXus developer to indicate which background features are required by the application. This property is available for Smart Device Main objects, under the iOS > Permissions group.


Every value corresponds to a string indicating the name of the functionality that the developer wants to execute in background mode.

Some of the available background modes correspond to GeneXus functionality and need to be added depending on the features used in the application. Some other background modes have no mapping to GeneXus features but are also supported in case the applications use a User Control or External Object that requires them.

The following values are supported by GeneXus features, and should be added in the cases described below:

audio Play or record audio in background mode.
Can be used for Audio external objectAudioController controlAudioRecorder external objectiPad Video player in Picture-in-Picture mode.
location Get location updates when the device location changes.
Can be used for Geolocation external object (Tracking).
remote-notification Download and process content when a silent push notification arrives.
Can be used for OneSignal API when the push notification includes media content (such as video).

It is not supported natively by GeneXus but could be required by a custom External Object or custom User Control developer for iOS.

voip Use the Internet to make and receive phone calls.
newsstand-content Download and process magazine or newspaper content.
external-accessory Update data from a hardware accessory.
bluetooth-central Update data from a Bluetooth accessory.
bluetooth-peripheral  Communicate through peripheral Bluetooth.
fetch Download and process small content regularly.

These values can be composed by adding a ',' (comma). For example, suppose that the application needs to execute the following features when running in background mode:

  • audio playback
  • remote notifications
  • fetching content

Then, the value of this property should be:

Background Modes property = audio,remote-notification,fetch


For previous versions of GeneXus, this process must be done manually from the generated XCode project as follows:

By XCode By GeneXus template
1) Locate the "Capabilities" tab.
2) Enable the "Background Modes" switch.
3) Check the proper value. For example, the "Audio, AirPlay and Picture in Picture" option enables the 'audio' value.  
AudioController - Background Mode - XCode

1) Locate the MainName-Info.plist in the <GeneXus_installation>\iOS\Templates\iOS_Genexus directory, and open it. 
2) Add the entry UIBackgroundModes with an array of string values (an entry for each property value desired). For example, in case that developer wants to enable the 'audio' value, include it as a <string> value



This property applies only at design-time.

How to apply changes

To apply changes made by this property, do a Build All.


This property is available since GeneXus 15 Upgrade 5.


Objects: Main Smart Devices
Platforms: Smart Devices(IOS)

See Also