# Titanium.App.Properties > The App Properties module is used for storing application-related data in property/value pairs that persist beyond application sessions and device power cycles. - Source: https://titaniumsdk.com/docs/sdk/12.6.3/Titanium.App.Properties - Titanium SDK version: 12.6.3 - Kind: module - Platforms: Android, iPhone, iPad, macOS - Since: Titanium SDK 0.5 - Extends: Titanium.Module - Inheritance: Titanium.Module > Titanium.Proxy #### App Properties in the tiapp.xml file App properties defined in the `tiapp.xml` file may be accessed using these APIs. An app property is defined inside the root-level `` element with the `` element. Use the `name` attribute to define your property name and place the value inline with the `` element. For example, to define an app property called `foo` with the value `42`: ``` xml 42 ``` Then, you can retrieve the property during runtime with the following API call: ``` js const foo = Ti.App.Properties.getString('foo'); ``` Any application properties defined in the `tiapp.xml` file are stored in the device's secure storage, making them read-only. Additionally, external access to these properties is now restricted. Other iOS applications cannot access these properties and native Android modules must use the Titanium module API TiApplication.getAppProperties() method to access these properties. If you need to change the values during runtime, initially create the property with these APIs rather than defining them in the `tiapp.xml` file. **Important**: Using this API in the Apple ecosystem requires the `NSPrivacyAccessedAPICategoryUserDefaults` property set in the privacy manifest that was introduced in iOS 17. You can learn more about it [here](https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api). ## Example: Store a property Store a string property. ``` js Ti.App.Properties.setString('givenName', 'Paul'); Ti.API.info('The value of the givenName property is: ' + Ti.App.Properties.getString('givenName')); ``` ## Example: Enumerate over saved properties Output all saved properties to the console. ``` js var props = Ti.App.Properties.listProperties(); for (var i = 0, ilen = props.length; i < ilen; i++){ var value = Ti.App.Properties.getString(props[i]); Ti.API.info(props[i] + ' = ' + value); } ``` ## Methods ### getBool - Platforms: Android, iPhone, iPad, macOS Returns the value of a property as a boolean data type. Parameters: - `property` (String): Name of property. - `default` (Boolean, optional): Default value to return if property does not exist. Returns: Boolean ### getDouble - Platforms: Android, iPhone, iPad, macOS Returns the value of a property as a double (double-precision, floating point) data type. This method must only be used to retrieve properties created with [setDouble](https://titaniumsdk.com/docs/sdk/Titanium.App.Properties.md#setDouble). Parameters: - `property` (String): Name of property. - `default` (Number, optional): Default value to return if property does not exist. Returns: Number ### getInt - Platforms: Android, iPhone, iPad, macOS Returns the value of a property as an integer data type. This method must only be used to retrieve properties created with [setInt](https://titaniumsdk.com/docs/sdk/Titanium.App.Properties.md#setInt). Use [getDouble](https://titaniumsdk.com/docs/sdk/Titanium.App.Properties.md#getDouble) and [setDouble](https://titaniumsdk.com/docs/sdk/Titanium.App.Properties.md#setDouble) to store values outside the integer data type range of `-2,147,483,648` to `2,147,483,647`. Parameters: - `property` (String): Name of property. - `default` (Number, optional): Default value to return if property does not exist. Returns: Number ### getList - Platforms: Android, iPhone, iPad, macOS Returns the value of a property as an array data type. Parameters: - `property` (String): Name of property. - `default` (Array