Appendix B. Understanding the Config.xml File

Cordova uses a config.xml to control many of its build settings. When you scaffold your Ionic application, a basic config.xml file is generated for you. The config.xml file follows the W3C widget specification. It allows developers to easily specify metadata about their applications. This appendix will explain the various elements in this file and how you can customize them for your application.

Essential Properties

The widget element is the root element of our config.xml file. It supports the following attributes:


The unique identifier for your application. To ensure your ID conforms to all supported platforms, this must be reverse-domain name style (e.g., com.yourcompany.yourapp). Unless you supply an app ID during the use of the Ionic CLI command, it will be com.ionicframework.[app name]+random number.


For best results, use a major/minor/patch style version, with three numbers, such as 0.0.1.


(Optional) when building for Android, you can set the versionCode by specifying it in your config.xml.


(Optional) when building for iOS, you can set the version for iOS.


(Optional) when building for Windows, you can set the version for Windows.


(Optional) when building for Windows, you can define the package name.

<widget id="com.ionicframework.ionic2do146695" version="0.0.1"↵
 xmlns="" ↵

Within the ...

Get Mobile App Development with Ionic 2, 1st Edition now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.