<!--
{
  "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/StoreContent/preferredSubscriptionPricingTerms(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "StoreKit",
      "SwiftUI",
      "_StoreKit_SwiftUI"
    ],
    "preciseIdentifier" : "s:17_StoreKit_SwiftUI0A7ContentPAAE33preferredSubscriptionPricingTermsyQr0aB07ProductV0G4InfoV0hI0VSgAG_AItcF"
  },
  "title" : "preferredSubscriptionPricingTerms(_:)"
}
-->

# preferredSubscriptionPricingTerms(_:)

Sets the pricing terms that the store uses to merchandise the subscription options within this store content.

```
nonisolated func preferredSubscriptionPricingTerms(_ pricingTerms: @escaping (Product, SubscriptionInfo) -> SubscriptionInfo.PricingTerms?) -> some StoreContent
```

## Parameters

`pricingTerms`

A closure that the system calls before it draws each subscription product. The closure receives the product and its subscription information. Return the pricing terms to use for that subscription option, or `nil` to use the subscription’s default pricing terms.

## Discussion

Use this modifier on a [`SubscriptionOptionGroup`](/documentation/StoreKit/SubscriptionOptionGroup) or other store content to choose the pricing terms for the subscription options within that content. Different groups in one subscription store view can then show the same products with different pricing terms, for example, a group that shows seat-based pricing terms for multiseat purchases.

Unlike the <doc://com.apple.documentation/documentation/SwiftUI/View/preferredSubscriptionPricingTerms(_:)> view modifier, which applies to every subscription store in the view, this modifier applies only to the store content you apply it to. The pricing terms you set override pricing terms that you set in ancestor views. If the pricing terms you return don’t exist for a subscription, the store uses the subscription’s default pricing terms.

To read the pricing terms in a custom control style, use [`preferredPricingTerms`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/Option/preferredPricingTerms).

---

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)