RefreshRank
RefreshRank DocsUpdated August 2026

Getting started

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

2.1Install the plugin

Install RefreshRank from the WordPress plugin directory (Plugins → Add New → search "RefreshRank"), or download the zip from the plugin page 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.2Create your account

On RefreshRank → Settings, Step 1 offers two paths:

2.3Connect 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.

CautionYour 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.

2.4Run 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.

2.5Read 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: SEC 3 - how rewrites and the approval diff work.