To provide users with more time to resolve renewal payment issues, and lower subscription involuntary churn rates, we’re increasing the default account hold duration on December 1, 2025. Starting on this date, by default account hold durations will be automatically calculated. Initially, the calculation will be 60 days minus any grace period duration, but we may change these calculations in the future to further improve recovery performance. We recommend using this automatically calculated setting, but if needed you can instead specify a custom, static value.
On December 1, 2025, all existing auto-renewing and installment base plans with the previous default value of 30 days will change to automatically calculated. Base plans with any other value will not be changed.
Starting on December 1, 2025, new base plans will default to automatically calculated.
You should always use the Google Play developer API SubscriptionPurchaseV2 to determine a user’s current subscription state, including the account hold and expired states. Assuming a static value in your app, backend, CRM, or other systems may result in a confusing user experience or other issues.
Changes to monetization.subscriptions Play Developer API
Currently, the account hold period can be configured through the monetization.subscriptions Play Developer API using the accountHoldDuration field on AutoRenewingBasePlanType and InstallmentsBasePlanType. If this field is not set on request, it defaults to P30D. At present, this field and its value will always be available in the response when you retrieve the base plan details in AutoRenewingBasePlanType or InstallmentsBasePlanType.
Starting from December 1, 2025, an empty or unset accountHoldDuration field will be used to represent the automatically calculated account hold duration. This field will no longer be guaranteed to be set on responses, as it will be unset for base plans with the automatically calculated account hold.
What You Need to Do
No action is required, but consider:
- A side effect of lengthening an account hold period is a temporary, likely substantial decrease in the involuntary churn rate, as subscriptions currently in account hold will not be canceled until a later date.
- While we recommend the automatic setting, if you need to keep your account hold duration at 30 days, you’ll need to reset the value back to 30 after December 1, 2025. You can do this using the Play Console or the Play Developer APIs.