---
title: DefaultStorage Module
description: Provides persistent data storage, backed by UserDefaults.
url: https://docs.tealium.com/platforms/ios-swift-v1/module-list/defaults-storage/
---
## Usage


<blockquote>
If you are using Swift 1.8.0+, this module is already included in the Core and you do not need to install it. For prior version, follow this guide to install the module.
</blockquote>


The DefaultStorage Module provides persistent data storage, backed by UserDefaults. This module must be used in conjunction with the Swift Module: [PersistentData](https://docs.tealium.com/platforms/ios-swift-v1/module-list/persistent-data/).

If you are using the Persistent Data module (Recommended), you must also use either the Defaults Storage or File Storage module to make the data persist across app launches. Whether you choose Defaults Storage over File Storage is personal choice. If both FileStorage and DefaultsStorage are included and enabled, FileStorage take precedence and DefaultsStorage effectively becomes inactive.

The following platforms are supported:

* iOS
* tvOS
* watchOS
* macOS

## Install

Install the DefaultStorage module with CocoaPods or Carthage.

### CocoaPods

To install the DefaultStorage module with CocoaPods, add the following pod to your Podfile:  
```ruby
pod 'tealium-swift/TealiumDefaultsStorage'
```

The framework is auto-instantiated. It has a dependency on the `TealiumCore` pod. It also bundles the PersistentData module. [Learn more](https://docs.tealium.com/platforms/ios-swift-v1/install/#cocoapods) about CocoaPods installation for iOS.


### Carthage

To install the DefaultStorage module with Carthage, following these steps:

1. Go to the app target's General configuration page in Xcode.

2. Add the following framework to the **Embedded Binaries** section:  
      ```ruby
      TealiumDefaultsStorage.framework
      ```
3. To access the persistentData API on the `Tealium` instance, add the following required import statement to your project:   
      ```swift
      import TealiumDefaultsStorage
      ```

The framework is auto-instantiated. It has a dependency on `TealiumCore`. It also bundles the PersistentData module. No additional import statements are necessary. [Learn more](https://docs.tealium.com/platforms/ios-swift-v1/install/#carthage) about Carthage installation for iOS.



## Data Layer

No additional variables are introduced by this module.

## API Reference

There are no public API methods for this module. Successes and failures may be monitored through the Delegate module.

## Release Notes

Build 1

* Initial release