---
updatedAt: 2026-08-19T21:11:32.000Z
agentTools:
  siteIndex: https://docs.recurly.com/llms.txt
  projectIndex: https://docs.recurly.com/recurly-subscriptions/llms.txt
---

# Renewal declines

Learn how to use Recurly's Renewal Decline Rate dashboard to track why renewals fail and compare your performance against industry benchmarks.

<div class="rp-page">
  <div class="rp-overview">The Renewal Decline Rate dashboard shows you insights on renewals that fail on the initial transaction attempt, so you can evaluate your payment method and gateway strategy and compare your decline rate against industry benchmarks.</div>
  <div class="rp-plan"><i class="fa-solid fa-key" aria-hidden="true"></i> Available on all Recurly plans</div>
  <div class="rp-toc">
    <a class="rp-toc-pill" href="#definition"><span class="rp-toc-num">1</span>Definition</a>
    <a class="rp-toc-pill" href="#key-benefits"><span class="rp-toc-num">2</span>Key benefits</a>
    <a class="rp-toc-pill" href="#key-details"><span class="rp-toc-num">3</span>Key details</a>
  </div>
</div>

### Prerequisites

<ul class="rp-list">
  <li>Users must have Analytics user role permission.</li>
</ul>

# Definition

<div class="rp-definition">The Renewal Decline Rate dashboard shows you insights on renewals that fail on the initial transaction attempt, helping you understand the effectiveness of your payment method and gateway strategy so you can lower your decline rate. Compare yourself to others in your industry with Recurly's built-in benchmarks.</div>

# Key benefits

<div class="rp-benefits rp-benefits-2x2">
  <div class="rp-benefit">
    <div class="rp-benefit-icon"><i class="fa-solid fa-circle-check" aria-hidden="true"></i></div>
    <strong>Industry comparison</strong>
    <span>Compare key subscription metrics with industry benchmarks to see how you stack up against peers, and spot your strengths and weaknesses.</span>
  </div>
  <div class="rp-benefit">
    <div class="rp-benefit-icon"><i class="fa-solid fa-circle-check" aria-hidden="true"></i></div>
    <strong>Competitive insights</strong>
    <span>See how competitors are performing on the same subscription metrics, and find areas where you can differentiate and improve.</span>
  </div>
  <div class="rp-benefit">
    <div class="rp-benefit-icon"><i class="fa-solid fa-circle-check" aria-hidden="true"></i></div>
    <strong>Informed decision-making</strong>
    <span>Make decisions based on real-world data to set realistic goals for subscription growth and customer retention.</span>
  </div>
  <div class="rp-benefit">
    <div class="rp-benefit-icon"><i class="fa-solid fa-circle-check" aria-hidden="true"></i></div>
    <strong>Forecasting and planning</strong>
    <span>Enable more accurate forecasting and long-term planning, so you can set reachable growth targets and allocate resources effectively.</span>
  </div>
</div>

# Key details

## General filters (top left corner)

<ul class="rp-list">
  <li><strong>Invoice creation date</strong>: Use the dropdowns to specify a timeframe and date range, up to the past 18 months, reflected on the dashboard.</li>
  <li><strong>Gateway</strong>: View your renewal declines across all gateways, or select a specific gateway to explore.</li>
  <li><strong>Failure type</strong>: Shows the top 5 decline reasons by default; adjust the filter to see more.</li>
  <li><strong>Payment type</strong>: Review your renewal declines by specific payment method.</li>
  <li><strong>Metric type</strong>: View by transaction count or total amount.</li>
</ul>

## Declined renewal invoices

View your decline rate trend over time to monitor your decline rate and catch any growing issues with renewals early. Compare a similar timeframe year-over-year to understand your performance. Decline rate graphs are shown as both a rate and a count.

<div class="rp-callout rp-callout-note">
  <div><strong><i class="fa-solid fa-circle-info" aria-hidden="true"></i> Note</strong>The number of invoices shown for the current month will be lower than for previous months, since invoices continue to be generated as the month goes on.</div>
</div>

<Image src="https://files.readme.io/5f95957edce7ff4d30c28190107955bbc8e30048637c1418974b2f55782efe01-image.png" align="center" width="75%" border={true} />

## Payment failure types by invoice count

This section shows your payment failure types by invoice count, giving you a detailed view of failure types for invoices that failed on the first attempt to collect:

<ul class="rp-list">
  <li>The overall invoice count during the dashboard's date range.
    <ul>
      <li>The invoice count at the start of the date range.</li>
      <li>The invoice count at the end of the date range.</li>
      <li>The percentage this count has increased or decreased since the start of the date range.</li>
    </ul>
  </li>
</ul>

## Decline reasons

Dive into the specific decline reasons for invoices that failed on the first attempt. These graphs break down by count and percentage of total failed invoices, helping you spot any changes in your overall failure types.

<Image src="https://files.readme.io/9f9445d0fecbbae89f63e50f9eea6fafc42fd3cd615bf113d0b96f3f3434b849-image.png" align="center" width="75%" border={true} />

## Gateways and payment methods summary

See which gateways and payment methods are performing well on renewal. These tables show how each of your gateways, and the payment methods and card brands they support, are performing.

For each of these areas, you get a detailed count of renewal invoices, renewal invoices failed on the first attempt to collect, renewal decline rate, and rate change during your selected date range.

<Image src="https://files.readme.io/62608b0a7862857eaf89e2ff022378b9e1b4faa436f7ab87348d9afe52246b6c-image.png" align="center" width="75%" border={true} />

<Image src="https://files.readme.io/77afd239194d1f50c3f135cac13d191dae325807570b5ad590f3675d4931cb72-image.png" align="center" width="75%" border={true} />

<Image src="https://files.readme.io/c547665c0f64f0a388119de4ec6de944a5d2559fc00f07039d38143866e3633a-image.png" align="center" width="75%" border={true} />

## Related dashboards

Explore related dashboards to learn more about how Recurly helps prevent churn and lower your renewal invoice decline rate. Review your dunning campaign strategy too, to keep increasing your dunning recoveries.

<Image src="https://files.readme.io/a1f4ba8-image.png" align="center" width="75%" border={true} />

# Sibling pages

* [Subscriber churn benchmarks](https://docs.recurly.com/recurly-subscriptions/docs/subscriber-churn-benchmarks.md)
* [Subscriber churn analysis](https://docs.recurly.com/recurly-subscriptions/docs/subsciber-churn-analysis.md)
* [Renewal benchmarks](https://docs.recurly.com/recurly-subscriptions/docs/renewal-benchmarks.md)
* [Renewal invoices](https://docs.recurly.com/recurly-subscriptions/docs/renewal-invoices.md)
* [Renewal invoices trendalyzer](https://docs.recurly.com/recurly-subscriptions/docs/renewal-invoices-trendalyzer.md)
* [Recovered revenue](https://docs.recurly.com/recurly-subscriptions/docs/recovered-revenue.md)
* [Renewal declines trendalyzer](https://docs.recurly.com/recurly-subscriptions/docs/renewal-declines-trendalyzer.md)