> For the complete documentation index, see [llms.txt](https://en.docs.monaca.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en.docs.monaca.io/reference/config/android/config_xml.md).

# config.xml

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

![](/files/-MfbKY5mbb__idSdMAl0)

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                                                                                                                                                       |
| `android-versionCode` | String | (Automatically set) When `version` attribute is `"1.22.33"`, it will be 102233 (=1 \* 10000 + 22 \* 100 + 33). If the project uses Crosswalk, it will be `2xxxxxx` for ARM architecture and `7xxxxxx` for x86 architecture. | An internal version code. It is used only to determine whether one version is more recent than others. Higher number indicates a more recent version. This version number is not shown to users. |

**Example**

```markup
<widget id="com.example.helloworld" version="0.0.1" android-versionCode="7">
  ...
</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
<widget id="com.example.helloworld" version="1.0.0">
  ...
  <content src="https://monaca.io/" />
</widget>
```

### \<access> element

| Attribute | Type   | Default Value | Description                                                                                                        |
| --------- | ------ | ------------- | ------------------------------------------------------------------------------------------------------------------ |
| `origin`  | String | `*`           | It is used to declare 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                                                                                                                                                                                                                                                                                                                             |
| --------------------------------- | ------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `KeepRunning`                     | Boolean | `true`        | Determines whether Cordova will keep running in the background or not.                                                                                                                                                                                                                                                                  |
| `DisallowOverscroll`              | Boolean | `false`       | Sets to true if you don’t want the interface to display any feedback when users scroll past the beginning or end of content.                                                                                                                                                                                                            |
| `Fullscreen`                      | Boolean | `false`       | Allows you to hide the status bar at the top of the screen.                                                                                                                                                                                                                                                                             |
| `SplashScreenDelay`               | Number  | `3000`        | Sets the default delay of how long the splashscreen appears in milliseconds. This should be the worst-case expected start time.                                                                                                                                                                                                         |
| `LogLevel`                        | String  | `ERROR`       | Sets the minimum log level through which log messages from your application will be filtered. There are 5 valid values such as: `ERROR`, `DEBUG`, `WARN`, `INFO` and `VERBOSE`.                                                                                                                                                         |
| `AndroidPersistentFileLocation`\* | String  | `Internal`    | <p>Sets where to store Android persistent files. There are 2 valid values. </p><p></p><ul><li><code>Internal</code>: will put persistent files under the user’s application internal storage directory.</li><li><code>Compatibility</code>: will put persistent files under storage root.</li></ul>                                     |
| `ScreenOrientation`\*\*           | String  | `default`     | <p>(Cordova 5.2 or Higher) Sets screen orientation for devices. There are 3 valid values. </p><p></p><ul><li><code>default</code>: uses system default screen orientation.</li><li><code>landscape</code>: sets screen orientation to landscape mode.</li><li><code>portrait</code> sets screen orientation to portrait mode.</li></ul> |

**Example**

```markup
...
<preference name="KeepRunning" value="false" />
<preference name="DisallowOverscroll" value="true"/>
<preference name="Fullscreen" value="true" />
<preference name="SplashScreenDelay" value="10000" />
<preference name="loglevel" value="DEBUG" />
<preference name="AndroidPersistentFileLocation" value="Internal" />
<preference name="orientation" value="default"/>
...
```

**\***: If your application has previously been shipped to users, using an older (pre- 3.0.0) version of this plugin, and has stored files in the persistent filesystem, then you should set the preference to Compatibility if your `config.xml` does not specify a location for the persistent filesystem. Switching the value of `AndroidPersistentFileLocation` to `Internal` would mean that existing users who upgrade their application may be unable to access their previously-stored files, depending on their device.

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

1. Global Settings:

   ```markup
   <widget>
    ....
    <preference name="orientation" value="default"/>
    ....
   </widget>
   ```
2. Platform Specific Settings:

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

## Specify the target API level

You can specify any target API level by using `android-targetSdkVersion` in the `<preference>` tag.

```markup
<platform name="android">
    ...
    <preference name="android-targetSdkVersion" value="29" />
    ...
</platform>
```