# Manage delinquency periods

A delinquency period is the length of time after which the subscription is churned if an invoice is not paid. Delinquency periods can be applied to a subscription or to an invoice. When a subscription is churned, the status of the subscription is set to `churned`. For more information, see [Subscription status](/docs/dev-docs/subscriptions#subscription-status).

If the delinquency period is not set on an order, the subscription remains active when payments fail. You must configure the delinquency period to enable automatic cancellation of unpaid subscriptions.

## Add delinquency periods to all orders

To add a delinquency period to all orders, see [Delinquency period for all orders](/docs/settings/organizations-and-websites#delinquency-period-for-all-orders).

## Add or edit a delinquency period

Use this process to add a delinquency period to a subscription or related invoice.

If you add a delinquency period to an active order, it is applied to all new invoices created for the order. It is not applied to the unpaid and past-due invoices. To apply a delinquency period to unpaid and past-due invoices, see [Add a delinquency period to an unpaid invoice](/docs/data-tables/manage-delinquency-periods#add-a-delinquency-period-to-an-unpaid-invoice).

1. [Log in](https://app-sandbox.rebilly.com/login) to Rebilly.
2. In the left navigation bar, press , then press **Billing**.
3. Press **Active subscriptions**, **Paid invoices**, or **Unpaid invoices**.
4. In the **ID** column, press a subscription.
5. In the top right of the screen, in the **Order details** section, press **Edit**.
6. Select from the following:
Add a delinquency period  1. Select the **Activate delinquency period** checkbox.
  2. Specify the length of time after which the subscription is canceled if it is not paid.
  3. Press **Save**.
Edit a delinquency period  1. Edit the length of time after which the subscription is canceled if it is not paid.
  2. Press **Save**.


## Add a delinquency period to an unpaid invoice

Use this process to add a delinquency period to an unpaid invoice.

1. [Log in](https://app-sandbox.rebilly.com/login) to Rebilly.
2. In the left navigation bar, press , then press **Billing**.
3. Press **Unpaid invoices**.
4. In the **ID** column, press an invoice.
5. In the top right of the invoice, in the **Delinquency date** field, specify the length of time after which the subscription is canceled if the invoice is not paid.


## Filter invoices by delinquency time and collection period

Use this process to filter invoices by delinquency period time and delinquent collection period in a data table.

The delinquency period time is the length of time after which a subscription is canceled if an invoice is not paid. The delinquent collection period is the length of time between when the invoice is due and when it is paid, or when it is canceled.

1. [Log in](https://app-sandbox.rebilly.com/login) to Rebilly.
2. In the left navigation bar, press , then press **Billing**.
3. Press **Unpaid invoices**, **Paid invoice**, or **Refunded invoices**.
4. In the top right of the table, press .
5. Select from the following:
Filter invoices by delinquency timeThis process filters invoices by the length of time that they were abandoned before being paid.
  1. In the search field, enter `Delinquency time`.
  2. In the next dropdown, select one of the following:
    - **Is relative**: Filter invoices by a relative time frame. For example, from 1 week ago until now.
    - **Is absolute**: Filter invoices by a specific time frame. For example, from 1/1/2021 until 1/1/2022.
    - **Is empty**: Filter invoices based on not having a delinquency time.
    - **Is not empty**: Filter invoices based on having a delinquency time.
  3. Press **Apply filter**, or **Apply filters**.
Filter invoices by delinquent collection periodThis process filters invoices by the length of time between when the invoice is due and when it is paid.
  1. In the search field, enter `Delinquent collection period`.
  2. In the next dropdown, select one of the following:
    - **Equals**: Filter invoices by a specific delinquent collection period length. For example, 5 days.
    - **Is between**: Filter invoices by a delinquent collection period length that is between two values. For example, between 5 and 10 days.
    - **Greater or equal to**: Filter invoices based on having a delinquent collection period that is greater than or equal to a specific length. For example, greater than or equal to 5 days.
    - **Lesser or equal to**: Filter invoices based on having a delinquent collection period that is lesser than or equal to a specific length. For example, lesser than or equal to 5 days.
  3. Press **Apply filter**, or **Apply filters**.
6. Optionally, to save the filtered data to the active segment: In the left of the screen, beneath the filters, press **Save**.
7. Optionally, to create a new segment based on the filtered data:
  1. In the left of the screen, beneath the filters, press **Save segment as**.
  2. Enter a name for the new segment, and then press **Save**.
8. Optionally, to customize how data is displayed in the data table, see [Customize tables](/docs/data-tables/customize-tables).


## View the delinquency period of a subscription

Use this process to view the delinquency period on a subscription invoice.

1. [Log in](https://app-sandbox.rebilly.com/login) to Rebilly.
2. In the left navigation bar, press , then press **Billing**.
3. Press **Active subscriptions**, **Paid invoice**, or **Unpaid invoices**.
4. In the **ID** column, press a subscription. 
In the top left of the invoice, **Delinquency period** is displayed.


## View all invoices by delinquency period

Use this process to view and filter all invoices by delinquency period in a data table.

1. [Log in](https://app-sandbox.rebilly.com/login) to Rebilly.
2. In the left navigation bar, press , then press **Billing**.
3. Press **Active subscriptions**, **Paid invoices**, or **Unpaid invoices**.
4. In the top right of the table, press .
5. In the search field, enter `delinquency` or `delinquent`, then select from the following fields to add to the data table:
  - **Delinquency period**: Length of time that is added to the due time of the subscription when setting the delinquency time for all related invoices.
  - **Initial invoice delinquency time**: Amount of the delinquency period that expired before the initial invoice was paid.
  - **Initial invoice delinquent collection period**: Length of time, in days, between when the initial invoice is due and when it is paid.
  - **Recent invoice delinquency time**: Amount of the delinquency period that expired before a recent invoice was paid.
  - **Recent invoice delinquent collection period**: Length of time, in days, between when the recent invoice is due and when it is paid.
  - **Upcoming invoice delinquency time**: Amount of the delinquency period that has expired before the upcoming invoice is paid.
  - **Upcoming invoice delinquent collection period**: Length of time, in days, between when the upcoming invoice is due and when it is paid.
6. Optionally, to save the filtered data to the active segment:
  1. In the top right of the table, press .
  2. Press **Save**.
7. Optionally, to save the filtered data to the active segment: In the left of the screen, beneath the filters, press **Save**.
8. Optionally, to customize how data is displayed in the data table, see [Customize tables](/docs/data-tables/customize-tables).