> 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/ios/monacaapp_info_plist.md).

# MonacaApp-Info.plist

You can configure your iOS app in MonacaApp-Info.plist file. For information on `plist` file, please refer to [Information Property List Files (Apple)](http://developer.apple.com/library/ios/documentation/general/Reference/InfoPlistKeyReference/Articles/AboutInformationPropertyListFiles.html). This file is located under `ios` folder inside your Monaca project as shown below:

![](/files/-MfboUKIpv3doxUrQCt9)

{% hint style="info" %}
For Cordova 6.2 or higher, `MonacaApp-Info.plist` file is removed from Monaca framework. Therefore, in order to config iOS application settings, use [Cordova Custom Config Plugin](/reference/third_party_phonegap/custom_config.md).
{% endhint %}

```markup
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist>
  <dict>
    <key>key</key>
    <value-type>value</value-type>
      ...
    <key>key</key>
    <array>
      <value-type>value</value-type>
      <value-type>value</value-type>
    </array>
    ...
  </dict>
</plist>
```

Inside `MonacaApp-Info.plist` file, there are 3 main types of elements:

* `<key>`: Defines value (plistObject) and a combination of application configuration information.
* `<array>`: You can have the array of values (plistObject).
* `<dict>`: Key and combination of value (plistObject) are defined here.

For example:

```markup
<plist>
  <dict>
    ...
    <key>XXX</key>
      <string>The value(plistObject) corresponding to key(XXX)</sting>
      ...
    <key>YYY</key>
      <array>
        <string>The 1st value(plistObject) corresponding to key(YYY)</string>
        <string>The 2nd value(plistObject) corresponding to key(YYY)</string>
        <string>The 3rd value(plistObject) corresponding to key(YYY)</string>
        <string>The 4th value(plistObject) corresponding to key(YYY)</string>
      </array>
    ...
  </dict>
</plist>
```

## Type List of Values (plistObject)

| Types   | Description                                       |
| ------- | ------------------------------------------------- |
| string  | String data type representing text.               |
| date    | Date data type representing date and time.        |
| Integer | Integer number                                    |
| real    | Floating data type representing a decimal number. |
| data    | Data type                                         |
| true    | true boolean                                      |
| false   | false boolean                                     |

## List of Keys

| Key                              | Type           | Description                                                                                                                                 |
| -------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| CFBundleDevelopmentRegion        | string         | Defines a native language of the developer. If the language of the user cannot be found, this value will be used as default.                |
| CFBundleDisplayName              | string         | Define a name of the application. It is a fully qualified name of the class that you extend from Application class.                         |
| CFBundleExecutable               | string         | Defines the application executable file.                                                                                                    |
| CFBundleIconFile                 | string         | Defines application icon file name.                                                                                                         |
| CFBundleIconFiles                | \<array>string | Defines icon file names used for iOS `3.2` or later. The correct file will be chosen depending on the size of the device screen resolution. |
| CFBundleIdentifier               | string         | Specifies a unique identifier for your application. The identifier must be a Uniform Type Identifier (UTI) as `com.monaca.MyApp`.           |
| CFBundleInfoDictionaryVersion    | string         | Is the current version number of `MonacaApp-Info.plist` file.                                                                               |
| CFBundleName                     | string         | Is a short display name of the app. It is limited to `16` characters at most.                                                               |
| CFBundlePackageType              | string         | Is a 4-digit code used to describe application type. Set this value to `APPL` for application project.                                      |
| CFBundleShortVersionString       | string         | Specifies the version number of your application.                                                                                           |
| CFBundleSignature                | string         | Is a 4-digit code used to identify the app developer.                                                                                       |
| CFBundleVersion                  | string         | Is a build version number of the application.                                                                                               |
| LSRequiresIPhoneOS               | true           | Indicates whether the application can only be run on iPhone or not.                                                                         |
| UISupportedInterfaceOrientations | \<array>string | Specifies screen orientations for iPhone that are supported by the application. For iPad, use `UISupportedInterfaceOrientations~ipad`.      |
| BackupWebStorage                 | string         | Set to cloud to allow the web storage data to be backed up to iCloud, Set to none to not allow any backups of web storage. default is cloud |

Here are some keys and values you may need to configure in your iOS apps:

## UISupportedInterfaceOrientations

Is used to set the screen orientation of your app:

* Settings for iPhone

  ```markup
  ...
  <key>UISupportedInterfaceOrientations</key>
    <array>
      <string>UIInterfaceOrientationLandscapeLeft</string>
      <string>UIInterfaceOrientationLandscapeRight</string>
      <string>UIInterfaceOrientationPortraitUpsideDown</string>
      <string>UIInterfaceOrientationPortrait</string>
    </array>
  ...
  ```
* Settings for iPad

  ```markup
  ...
  <key>UISupportedInterfaceOrientations~ipad</key>
    <array>
      <string>UIInterfaceOrientationLandscapeLeft</string>
      <string>UIInterfaceOrientationLandscapeRight</string>
      <string>UIInterfaceOrientationPortraitUpsideDown</string>
      <string>UIInterfaceOrientationPortrait</string>
    </array>
  ...
  ```

## List of Orientation Values

| Value                                    | Description                                                                      |
| ---------------------------------------- | -------------------------------------------------------------------------------- |
| UIInterfaceOrientationLandscapeLeft      | Landscape orientation aligned to the left side of the Home button.               |
| UIInterfaceOrientationLandscapeRight     | Landscape orientation aligned to the right side of the Home button.              |
| UIInterfaceOrientationPortraitUpsideDown | Portrait orientation                                                             |
| UIInterfaceOrientationPortrait           | Portrait orientation in opposite direction from the normal portrait orientation. |

You can download a sample screen orientation file below:

{% file src="/files/-MfbouGVvhqFHC2YeEi3" %}
Screen Orientation File
{% endfile %}

## Statusbar Setting

| Value                                    | Type    | Default | Description                                                                                                                                                                                                                             |
| ---------------------------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UIStatusBarHidden                        | Boolean | `false` | If set to `true`, the status bar at the top of the application will be hidden. If *UIStatusBarHidden* set to `true` and *UIViewControllerBasedStatusBarAppearance* set to `false`, the status bar at the top of the app will be hidden. |
| UIViewControllerBasedStatusBarAppearance | Boolean | `false` | If set to `true`, the status bar at the top of the application will be hidden. Set to `true` in order to use [StatusBar Plugin](/reference/core-cordova-plugins/cordova_10.0/statusbar.md).                                             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://en.docs.monaca.io/reference/config/ios/monacaapp_info_plist.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.