# SubscriptionStoreView A view that merchandises a collection of auto-renewable subscription options that belong to the same subscription group. ``` @MainActor @preconcurrency struct SubscriptionStoreView where Content : View ``` ## Overview A `SubscriptionStoreView` displays localized information about auto-renewable subscriptions, including their localized names, descriptions, and prices, as well as a purchase button. Create a subscription store view by using one of the initializers and providing the following information: - A subscription group identifier - A collection of product identifiers - A collection of product values you previously loaded from the App Store If you provide a subscription group identifier or a collection of product identifiers, the subscription store view automatically loads the subscription data from the App Store, and updates the view when the data is available. ### Provide a background and a decorative icon The subscription store view doesn’t draw a background by default. You can add a background as follows: - To layer a background behind the view, use a view modifier, such as `background(alignment:content:)`. - To set the container background of the subscription store using a view, use the `containerBackground(_:for:)` or `containerBackground(for:alignment:content:)` view modifier and specify a , such as . You can optionally provide a view as a decorative icon next to each subscription option. Use the view modifier to set a view that decorates individual subscription options within a subscription store. ### Order and filter subscriptions If you create the subscription store view by providing a subscription group identifier, the system orders the subscription options according to their rank. If the customer is already subscribed, you may want to merchandise upgrade or crossgrade options. By default, the subscription store view lists all the subscriptions in the group. To hide certain subscription options, provide the `visibleRelationships` parameter in the initializer. For more information about the visible relationships, see [`Product.SubscriptionRelationship`](/documentation/StoreKit/Product/SubscriptionRelationship). If you create the subscription store view using one of the other initializers, the view orders the subscriptions according to the collection parameter’s order. The view excludes subscriptions that you don’t include in the collection parameter. ### Add terms of service and privacy policies The `SubscriptionStoreView` automatically displays buttons for the terms of service and privacy policy that you submit in App Store Connect. To override the destination of these buttons with a URL to custom terms of service and privacy policy pages, or a custom view, use the modifiers and . Use modifiers, such as , to customize the button’s style, for example, to make the text more readable against your store’s background. ### Add auxiliary buttons You can show auxiliary buttons in the subscription store using view modifiers. Specify the button’s visibility within the subscription store by using the view modifier. If you offer your subscription through other services, you can configure the subscription store view to display a sign-in button. Use the modifier to set the function your app calls when someone uses the sign-in button. The subscription store view automatically shows a Close button. To override this behavior, use the `storeButton(_:for:)` modifier to unconditionally show, or hide, the Close button. ### Style the subscription store view You can further customize the subscription store’s appearance using control styles. Use subscription store control styles to customize the display of subscription options, and how people interact with your store. To try out standard styles, such as [`PickerSubscriptionStoreControlStyle`](/documentation/StoreKit/PickerSubscriptionStoreControlStyle), apply the style using the modifier. ## Topics ### Creating subscription store views with automatic marketing content [`init(groupID:visibleRelationships:)`](/documentation/StoreKit/SubscriptionStoreView/init(groupID:visibleRelationships:)) Creates a view that loads all subscriptions in a subscription group from the App Store, and merchandises them with automatic marketing content. [`init(productIDs:)`](/documentation/StoreKit/SubscriptionStoreView/init(productIDs:)) Creates a view that loads subscriptions based on a collection of product identifiers, and merchandises them with automatic marketing content. [`init(subscriptions:)`](/documentation/StoreKit/SubscriptionStoreView/init(subscriptions:)) Creates a view that displays a collection of subscription options, and merchandises them with automatic marketing content. ### Creating subscription store views with custom marketing content [`init(groupID:visibleRelationships:marketingContent:)`](/documentation/StoreKit/SubscriptionStoreView/init(groupID:visibleRelationships:marketingContent:)) Creates a view that loads all the subscriptions in a subscription group from the App Store, and merchandises them with custom marketing content. [`init(productIDs:marketingContent:)`](/documentation/StoreKit/SubscriptionStoreView/init(productIDs:marketingContent:)) Creates a view that loads a collection of subscriptions from the App Store, and merchandises them with custom marketing content. [`init(subscriptions:marketingContent:)`](/documentation/StoreKit/SubscriptionStoreView/init(subscriptions:marketingContent:)) Creates a view that displays a collection of subscription options, and merchandises them with custom marketing content. ### Creating subscription store views with a hierarchichal structure [`init(groupID:visibleRelationships:content:)`](/documentation/StoreKit/SubscriptionStoreView/init(groupID:visibleRelationships:content:)) [`init(productIDs:content:)`](/documentation/StoreKit/SubscriptionStoreView/init(productIDs:content:)) [`init(subscriptions:content:)`](/documentation/StoreKit/SubscriptionStoreView/init(subscriptions:content:)) ### Supporting types [`AutomaticSubscriptionStoreMarketingContent`](/documentation/StoreKit/AutomaticSubscriptionStoreMarketingContent) A view that represents the default marketing content for a subscription store. [`SubscriptionStoreContentView`](/documentation/StoreKit/SubscriptionStoreContentView) --- Copyright © 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)