# Titanium.App.iOS.UserDefaults

The UserDefaults module is used for storing application-related data in property/value pairs that persist beyond application sessions and device power cycles. UserDefaults allows the suiteName of the UserDefaults to be specified at creation time.

Availability
4.0.0
9.2.0

# Overview

Unlike Titanium.App.Properties, Titanium.App.iOS.UserDefaults does not pull properties defined in the tiapp.xml file.

To create a UserDefaults object, use the Titanium.App.iOS.createUserDefaults method.

# Examples

# Create a UserDefaults object

Creating a UserDefaults object

var props = Ti.App.iOS.createUserDefaults({
    suiteName: 'group.mySuite'
});

# Properties

# suiteName CREATION ONLY

Availability
4.0.0
9.2.0
suiteName :String

Sets the name of the suite to be used to access UserDefaults.