<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "StoreKit",
  "identifier" : "/documentation/StoreKit/Product/SubscriptionInfo/RenewalState",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "StoreKit"
    ],
    "preciseIdentifier" : "s:8StoreKit7ProductV16SubscriptionInfoV12RenewalStateV"
  },
  "title" : "Product.SubscriptionInfo.RenewalState"
}
-->

# Product.SubscriptionInfo.RenewalState

The renewal states of auto-renewable subscriptions.

```
struct RenewalState
```

## Overview

A subscription’s renewal state indicates whether an auto-renewable subscription is entitled to service. Subscriptions in the [`subscribed`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/subscribed) and [`inGracePeriod`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/inGracePeriod) states are entitled to service.

Subscriptions in the [`expired`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/expired), [`inBillingRetryPeriod`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/inBillingRetryPeriod), and [`revoked`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/revoked) states aren’t entitled to service if the customer doesn’t have other [`Product.SubscriptionInfo.Status`](/documentation/StoreKit/Product/SubscriptionInfo/Status-swift.struct) items that give them entitlement to service for that subscription. For example, a customer may have a status in the [`expired`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/expired) state for a subscription that they purchased individually, and another status in the [`subscribed`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/subscribed) state for the same subscription, which they get through Family Sharing. In that case, the customer has an entitlement to service for that subscription.

For more information about Family Sharing, see [Supporting Family Sharing in your app](/documentation/StoreKit/supporting-family-sharing-in-your-app). For more information about entitlements, see [`currentEntitlements`](/documentation/StoreKit/Transaction/currentEntitlements).

## Topics

### Getting the renewal state

[`subscribed`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/subscribed)

The customer is currently subscribed.

[`expired`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/expired)

The subscription expired.

[`inBillingRetryPeriod`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/inBillingRetryPeriod)

The subscription is in a billing retry period.

[`inGracePeriod`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/inGracePeriod)

The subscription is in a billing grace period state.

[`revoked`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/revoked)

The App Store has revoked the customer’s access to the subscription group.

### Getting a localized description

[`localizedDescription`](/documentation/StoreKit/Product/SubscriptionInfo/RenewalState/localizedDescription)

A string containing the localized description of the renewal state.


---

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)