# config.xml

The `config.xml` file is a settings file controlling various settings of Cordova.

![](https://3091308003-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MfWe1U2tFctp8FkP9W8%2F-MfbKSo1TZHyg7OKJhbR%2F-MfbMnFtP6mjCg5ib--s%2Fimage.png?alt=media\&token=1519acd0-55a0-4cb3-a33f-d66db602d371)

Below are available elements and preferences you may need to configure:

## \<widget> element

| Attribute | Type   | Default Value | Description                                |
| --------- | ------ | ------------- | ------------------------------------------ |
| `version` | String | `1.0.0`       | A version number which is visible to users |

**Example**

```markup
<widget id="com.example.helloworld" version="0.0.1">
  ...
</widget>
```

## \<content> element

| Attribute | Type   | Default Value | Description                                                                                                                                                                                         |
| --------- | ------ | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `src`     | String | `indext.html` | The `<content>` element defines the app's starting page in the top-level web assets directory. You can change the starting page by changing the value of the `src` attribute to your preferred URL. |

**Example**

```markup
<?xml version="1.0" encoding="UTF-8"?>
<widget xmlns="http://www.w3.org/ns/widgets" id="com.example.helloworld" version="1.0.0">
  ...
  <content src="https://monaca.io/" />
</widget>
```

## \<access> element

| Attribute | Type   | Default Value | Description                                                                                           |
| --------- | ------ | ------------- | ----------------------------------------------------------------------------------------------------- |
| `origin`  | String | `*`           | Controls access to specific network domains. If set to `*`, you can access all domains from your app. |

**Example**

```markup
...
<access origin="*" />
...
```

## \<preference> element

The `<preference>` tag sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms, as listed at the top of this page. The following sections detail preferences that apply to more than one platform.

| Preference Name              | Type    | Default Value | Description                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------- | ------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DisallowOverScroll`         | Boolean | `false`       | Set to `true` if you want to disable the rubber-band scrolling for WebView.                                                                                                                                                                                                                                                                                                                                                                 |
| `EnableViewportScale`        | Boolean | `false`       | Set to `true` to prevent viewport scaling through a `<meta>` tag.                                                                                                                                                                                                                                                                                                                                                                           |
| `AutoHideSplashScreen`       | Boolean | `true`        | Set to `false` to control the splashscreen when it’s hidden through a JavaScript API.                                                                                                                                                                                                                                                                                                                                                       |
| `BackupWebStorage`           | String  | `cloud`       | <p>There are 3 valid values: </p><p></p><ul><li><code>none</code>: disables any backups of web storage.</li><li><code>cloud</code>: allows the web storage data to be backed up to iCloud.</li><li><code>local</code>: allows only local backups (iTunes sync).</li></ul>                                                                                                                                                                   |
| `UIWebViewDecelerationSpeed` | String  | `normal`      | <p>Controls the deceleration speed of momentum scrolling. There are 2 valid values: </p><p></p><ul><li><code>normal</code>: is the default speed for most native apps</li><li><code>fast</code>: is the default speed for Mobile Safari.</li></ul>                                                                                                                                                                                          |
| `Orientation`\*              | String  | `default`     | <p>(Cordova 5.2 or Higher) There are 4 valid values: </p><p></p><ul><li><code>all</code>: to specify both portrait & landscape mode you would use the platform specific value all</li><li><code>default</code>: screen orientation will be applied according to system default.</li><li><code>landscape</code>: set screen orientation to landscape mode.</li><li><code>portrait</code>: set screen orientation to portrait mode.</li></ul> |

**Example**

```markup
...
<preference name="DisallowOverscroll" value="false" />
<preference name="EnableViewportScale" value="false" />
<preference name="AutoHideSplashScreen" value="true" />
<preference name="BackupWebStorage" value="cloud" />
<preference name="UIWebViewDecelerationSpeed" value="normal" />
<preference name="Orientation" value="portrait" />
...
```

**\***: There are two use ways to configure `Orientation` preference:

1. Global Settings:

   ```markup
   <widget>
   ....
   <preference name="orientation" value="default"/>
   ....
   </widget>
   ```

{% hint style="info" %}
It is also possible to apply the setting for all devices at once; however, you can only use `default`, `landscape` and `portrait` value. `all` is not possible for Global Settings.
{% endhint %}

&#x20;   2\. Platform Specific Settings:

```markup
<widget>
...
<platform name="ios">
 <preference name="orientation" value="default"/>
</platform>
...
</widget>
```

{% hint style="info" %}
For Android/Windows, `default` means all directions, but in iOS only portrait will be applied.
{% endhint %}