RefreshRank
RefreshRank Operating HandbookRevision: August 2026

Section 2 · Normal procedures

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.