<!--
{
  "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/displayFrequency(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "TipKit"
    ],
    "preciseIdentifier" : "s:6TipKit4TipsO19ConfigurationOptionV16displayFrequencyyA2E07DisplayG0VFZ"
  },
  "title" : "displayFrequency(_:)"
}
-->

# displayFrequency(_:)

Customizes how often new tips are presented in your app after another tip has been displayed.

```
static func displayFrequency(_ displayFrequency: Tips.ConfigurationOption.DisplayFrequency) -> Tips.ConfigurationOption
```

## Overview

Use `displayFrequency` to control how often new tips are displayed.
For example, if display frequency is set to `.daily` and your `FavoriteLandmarkTip` is displayed, no new tips
will be shown for at least 24 hours.

Display frequency only applies to tips that have not appeared.
Previously displayed tips will still appear if their display [`rules`](/documentation/TipKit/Tip/rules) are satisfied.

Individual tips can override this behavior by specifying [`IgnoresDisplayFrequency`](/documentation/TipKit/Tips/IgnoresDisplayFrequency) in their [`options`](/documentation/TipKit/Tip/options).

The default value for this option is [`immediate`](/documentation/TipKit/Tips/ConfigurationOption/DisplayFrequency/immediate).

Display frequency can be set using [`configure(_:)`](/documentation/TipKit/Tips/configure(_:)):

```swift
@main
struct SampleApp: App {
    init() {
        do {
            // Configure your tips with a daily display frequency.
            try Tips.configure([
                .displayFrequency(.daily)
            ])
        }
        catch {
            // Handle TipKit errors
            print("Error initializing TipKit \(error.localizedDescription)")
        }
    }
}
```

### Display Frequency Values

[`immediate`](/documentation/TipKit/Tips/ConfigurationOption/DisplayFrequency/immediate)

An immediate display frequency.

[`daily`](/documentation/TipKit/Tips/ConfigurationOption/DisplayFrequency/daily)

A daily display frequency.

[`hourly`](/documentation/TipKit/Tips/ConfigurationOption/DisplayFrequency/hourly)

A hourly display frequency.

[`weekly`](/documentation/TipKit/Tips/ConfigurationOption/DisplayFrequency/weekly)

A weekly display frequency.

[`monthly`](/documentation/TipKit/Tips/ConfigurationOption/DisplayFrequency/monthly)

A monthly display frequency.


---

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)