<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 18.0.0 -",
    "visionOS: 2.0.0 -",
    "watchOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "StoreKit",
  "identifier" : "/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "StoreKit",
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:17_StoreKit_SwiftUI012SubscriptionA25ControlStyleConfigurationV7optionsSayAC6OptionVGvp"
  },
  "title" : "options"
}
-->

# options

An array of subscription options for the subscription store view to merchandise.

```
var options: [SubscriptionStoreControlStyleConfiguration.Option] { get }
```

## Discussion

The [`options`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options) property is an array that contains the main content of your subscription store control style, including the auto-renewable subscription products. Use the properties of each [`options`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options) value to declare your control style. Provide a control that enables the customer to subscribe to each option in the array. Call the [`subscribe()`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/Option/subscribe()) method when the customer activates a control to subscribe.

Display only the subscription options that appear in the [`options`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options) array. Use the [`allOptions`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/allOptions) property to access information about all the options, for example, to compute comparisons between subscription options.

To hide and sort subscription options, use the initializer of the [`SubscriptionStoreView`](/documentation/StoreKit/SubscriptionStoreView). The [`options`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options) array maintains the sort order, and includes only the options you provide to the subscription store view’s initializer. For example, the following code initializes the subscription store to contain only the subscription options that upgrade the customer’s current subscription:

```swift
SubscriptionStoreView(groupID: "SAMPLE", visibleRelationships: .upgrade)
```

If you configure a subscription store view to show the current auto-renewal preference, the [`options`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options) array contains the [`autoRenewPreference`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/autoRenewPreference) subscription product. There’s no need to specifically display the [`autoRenewPreference`](/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/autoRenewPreference) product in that case.

> Note:
> A subscription store control style needs only one of the properties, ``doc://com.apple.storekit/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options`` or ``doc://com.apple.storekit/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/sections``. Use ``doc://com.apple.storekit/documentation/StoreKit/SubscriptionStoreControlStyleConfiguration/options`` if your style doesn’t support sections.

If you declare a subscription store view using [`SubscriptionOptionSection`](/documentation/StoreKit/SubscriptionOptionSection) instances, this property flattens the section structure and ignores any header or footer views.

---

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)