<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TipKit",
  "identifier" : "/documentation/TipKit/Tips/ConfigurationOption/datastoreLocation(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "TipKit"
    ],
    "preciseIdentifier" : "s:6TipKit4TipsO19ConfigurationOptionV17datastoreLocationyA2E09DatastoreG0VFZ"
  },
  "title" : "datastoreLocation(_:)"
}
-->

# datastoreLocation(_:)

Specify a custom location for your tips datastore.

```
static func datastoreLocation(_ storeLocation: Tips.ConfigurationOption.DatastoreLocation) -> Tips.ConfigurationOption
```

## Overview

Use `datastoreLocation` to change the on-disk location of your tips persistent storage.

By default `URL.applicationSupportDirectory` is used on macOS, iOS, watchOS, and visionOS.

On tvOS, `URL.cachesDirectory` is used by default in conjunction with `UserDefaults` to manage tip statuses.

```swift
@main
struct SampleApp: App {
    init() {
        do {
            // Save the tips datastore in a group container.
            try Tips.configure([
                .datastoreLocation(.groupContainer(identifier: "group.com.apple.TipKitTrails"))
            ])
        }
        catch {
            // Handle TipKit errors
            print("Error initializing TipKit \(error.localizedDescription)")
        }
    }
}
```

### Datastore Location Values

[`static var applicationDefault: Tips.ConfigurationOption.DatastoreLocation`](/documentation/TipKit/Tips/ConfigurationOption/DatastoreLocation/applicationDefault)

The default location for persisting tips, which is generally your application’s support directory.

[`static func groupContainer(identifier: String) throws -> Tips.ConfigurationOption.DatastoreLocation`](/documentation/TipKit/Tips/ConfigurationOption/DatastoreLocation/groupContainer(identifier:))

DatastoreLocation for persisting tips in a group container.

[`static func url(URL) -> Tips.ConfigurationOption.DatastoreLocation`](/documentation/TipKit/Tips/ConfigurationOption/DatastoreLocation/url(_:))

Configuration option for persisting tips at a custom on-disk location.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)