---
title: "Grace period"
description: "Understand how subscription grace periods work and improve user retention."
---

The Grace period chart displays the number of subscriptions that have entered the grace period state due to a [billing issue](billing-issue). During this period, the subscription remains active while the store tries to receive payment from the subscriber. If payment is not successfully received before the grace period ends, the subscription enters the billing issue state.

## Calculation

The grace period metric counts subscriptions that entered the grace period during the selected time range. The grace period starts when a subscription's renewal payment fails and lasts up to 6 days for weekly subscriptions or 16 days for other billing periods. If payment goes through during this window, the subscription continues normally; if not, the subscription enters the [billing issue](billing-issue) state.

## Available filters and grouping

:::link
Main article: [Analytics controls](controls-filters-grouping-compare-proceeds)
:::

- ✅ Filter by: Attribution, Audience, Country, Paywall, A/B tests, Placement, Period, Segment, Store, Product, and Duration.
- ✅ Group by: Product, Country, Store, Paywall, Audience, Placement, Duration, Segment, and Attribution.

## Similar metrics

For a side-by-side comparison of these metrics, see the [Metric comparison table](metric-comparison-table#billing-issues-and-revenue-recovery).

- [Refund money](refund-money)
- [Refund events](refund-events)
- [Billing issue](billing-issue)