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.
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:
| Column | Meaning |
|---|---|
| Decay | 0-100. How sharply this page's search performance is declining. |
| Potential | Estimated win-back: how much traffic a refresh could recover. The queue is sorted by this. |
| Suggested | What 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).