RefreshRank
RefreshRank Operating HandbookRevision: August 2026

Section 3 · Refresh system

The AI proposes, you decide, WordPress remembers. Nothing is ever applied without your approval.

3.1The five rewrite tasks

Clicking Rewrite on a queue row sends that post's title, meta description, and content (up to 30KB) to the RefreshRank service, along with the page's top search queries, which runs five focused tasks:

TaskWhat it proposes
TitleA higher click-through title, ≤ 60 characters, working the primary query in naturally.
MetaA meta description ≤ 155 characters with a clear value proposition.
IntroAn answer-first introduction that addresses the primary query in the first sentences, replacing the current first paragraph.
FAQ3-5 question/answer pairs, appended to the end of the post.
DatesFind/replace pairs for stale years (historical facts are left alone).

Generation runs through the RefreshRank service on a frontier OpenAI model (routed via OpenRouter, with routing pinned to OpenAI). You are never billed per token - rewrites only count against your plan's monthly quota. A full five-task job typically finishes in under a minute; the button shows your queue position and an ETA while you wait, and you can leave the page and come back.

3.2The review diff

When the job finishes, a review modal shows every proposal side by side: the current value in red, the proposed value in green. Read all of it - the AI is a careful drafter, but you are the editor. If anything is off, click Cancel and nothing happens at all.

3.3Approve & apply

Clicking Approve & apply writes the changes to the post on your own server:

3.4Rolling back

Applied changes are ordinary WordPress revisions. Open the post in the editor, click Revisions, and restore any earlier version - including the pre-refresh original. This works with WordPress's built-in tools; there is no RefreshRank-specific lock-in.

CautionQuota accounting: each requested rewrite job counts once against your monthly quota when you request it, whether or not you approve the result. Quotas reset on the 1st of each month.