<!--
{
  "availability" : [
    "iOS: 27.3.0 -",
    "iPadOS: 27.3.0 -",
    "macOS: 27.3.0 -",
    "tvOS: 27.3.0 -",
    "visionOS: 27.3.0 -",
    "watchOS: 27.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "StoreKit",
  "identifier" : "/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/Option/preferredPricingTerms",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "StoreKit",
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:17_StoreKit_SwiftUI012SubscriptionA25ControlStyleConfigurationV6OptionV21preferredPricingTerms0aB07ProductV0E4InfoV0kL0VSgvp"
  },
  "title" : "preferredPricingTerms"
}
-->

# preferredPricingTerms

The preferred pricing terms for this subscription option.

```
var preferredPricingTerms: SubscriptionInfo.PricingTerms? { get }
```

## Discussion

This property reflects the pricing terms from the <doc://com.apple.documentation/documentation/SwiftUI/View/preferredSubscriptionPricingTerms(_:)> view modifier on an ancestor view, or from the [`preferredSubscriptionPricingTerms(_:)`](/documentation/StoreKit/StoreContent/preferredSubscriptionPricingTerms(_:)) modifier on the enclosing store content. The value is `nil` when you don’t specify preferred pricing terms. It’s the subscription’s default pricing terms when the modifier’s closure returns `nil`, or when the pricing terms you specify don’t exist for the subscription.

Use this property in your custom [`SubscriptionStoreControlStyle`](/documentation/StoreKit/SubscriptionStoreControlStyle) to display pricing information that matches the pricing terms the store uses. For example, when the [`pricingModel`](/documentation/StoreKit/Product/SubscriptionInfo/PricingTerms-swift.struct/pricingModel-swift.property) is seat-based, display its [`priceTiers`](/documentation/StoreKit/Product/SubscriptionInfo/PricingTerms-swift.struct/SeatBasedPricing/priceTiers).

---

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)