RefreshRank

Getting started

From zip file to decay queue in four steps. No signup form, no API keys.

1. Install the plugin

Install RefreshRank from the WordPress plugin directory (Plugins → Add New → search "RefreshRank"), or download the zip and upload it via Plugins → Add New → Upload Plugin. Activate it. You'll find RefreshRank in the admin sidebar with two pages: Decay Queue and Settings.

Requirements: WordPress 6.5+, PHP 8.0+.

2. Create your account

On RefreshRank → Settings, Step 1 offers two paths:

  • Start free - one click creates a free account for this site. No email, no form. Your license key is generated and stored automatically.
  • Already have a license key? - paste it and click Save & activate. Use this if you bought a plan or redeemed an AppSumo code on another site and want to add this site to the same account.

3. Connect Google Search Console

Step 2's Connect Search Console button opens Google's consent screen in a new tab. Sign in with the Google account that owns this site's Search Console property and grant read-only access. The connection happens entirely between Google and the RefreshRank service - tokens are stored on our servers and never on your WordPress site.

Your site must be a verified property in Google Search Console first. Both URL-prefix properties (https://example.com/) and domain properties (sc-domain:example.com) work.

4. Run your first sync

Step 3's Sync now pulls up to 16 months of search history - per-page clicks, impressions, click-through rate, and position in 28-day windows - and scores every page. The first sync can take a few minutes on large sites. After that, RefreshRank re-syncs automatically every day; manual syncs are limited to once per hour.

Read your decay queue

Open RefreshRank → Decay Queue. Each row is a page with enough search history to score:

ColumnMeaning
Decay0-100. How sharply this page's search performance is declining.
PotentialEstimated win-back: how much traffic a refresh could recover. The queue is sorted by this.
SuggestedWhat the data suggests fixing - e.g. refresh content + FAQ or rewrite title/meta.

On the free plan the queue is fully visible; the Rewrite button becomes available on paid plans. The queue caches for one hour, so changes after a sync can take up to an hour to appear (or immediately after you visit Settings).

Next: how rewrites and the approval diff work.