Skip to content
SeoFreshUp Docs

AI rewrite

The AI rewrite engine produces a substantially better version of an article (800+ words, H2/H3 structure, fresh data, optimized meta) without losing what already ranks — existing internal links, images, commercial CTAs and outbound references are preserved verbatim.

When to use it

Three legitimate cases:

  1. Article flagged RETRAVAILLER by the AI verdict — the topic is worth keeping but the current version is thin/dated
  2. Article hit by a recent Core Update — needs E-E-A-T signals strengthened
  3. Article published 2+ years ago with declining traffic — refresh angle

Don’t use it on articles flagged GARDER (you’ll just churn ranking signals for nothing).

Triggering a rewrite

Two entry points:

  • From the Audit table: ⚡ Action → 🪄 Open AI rewrite on any row
  • From the post editor: a metabox in the right sidebar with 🪄 Open rewrite

Both open the same modal.

Optional: enrich with external URLs

Before the rewrite starts, a mini-form asks (optional):

  • 1-2 service URLs to feature (the plugin scrapes them via Firecrawl, extracts pricing/features, generates an “info-card” image, and weaves them into the article as outbound links)
  • 1 YouTube URL to embed in the body

This is useful for affiliate articles, brand-promoted content, or when you want to feature a specific tool. Skip it (30 s timer) for a standard rewrite.

What the rewrite preserves

The AI is explicitly instructed to keep:

  • ✅ Existing <img> tags (URLs unchanged) — placed naturally in body paragraphs
  • ✅ Featured image (or replaced if you enabled AI image generation in settings)
  • ✅ Existing internal links (max 2, picked from your blog’s relevant articles)
  • ✅ At least one commercial CTA if any existed (sales pages, signup, store)
  • ✅ Existing outbound references (citations, source links)
  • ✅ The article’s language (FR articles get FR rewrites)

What it changes

  • ✏ New SEO-optimized title (50-60 chars)
  • ✏ New meta description (140-160 chars, written into Yoast/RM/SEOPress automatically)
  • ✏ Restructured headings (H2/H3, each H2 ends with a question or benefit statement)
  • ✏ Intro paragraph that directly answers the main question (AI Search / GEO friendly)
  • ✏ Updated dates, statistics, examples
  • ✏ Length boosted to 900-1200 words minimum
  • ✏ Optional: a centered CTA before the FAQ pointing to the promoted URL

Reviewing before publishing

The modal shows 3 tabs:

  1. 📋 Améliorations — bullet list of what changed (with auto-checks: word count delivered, # internal links, # H2, etc.)
  2. 👁 Aperçu avant / après — side-by-side comparison
  3. 🔮 Estimation IA & Risque — re-runs the verdict + risk on the new version, so you see the predicted impact before applying

Applying

Two actions:

  • 📝 Sauver en brouillon — creates a new WordPress draft, original stays intact, you review in the editor before publishing
  • 🪄 Remplacer publié — replaces the article in-place (creates a WordPress revision so you can roll back)

Both options re-run the AI verdict + risk on the new content automatically.

Models

Default rewrite model: anthropic/claude-haiku-4.5 (good balance of quality and speed). Override in Settings → API Keys & Models → Rewrite model.

For maximum quality on cornerstone articles, switch to anthropic/claude-sonnet-4.6 (~3× the cost but noticeably better output).

For maximum speed/cost on bulk operations, openai/gpt-4o-mini works but produces less polished content.

Cost

ModelCost per rewrite (1500-word article)
gpt-4o-mini~$0.001
claude-haiku-4.5~$0.005
claude-sonnet-4.6~$0.015

Image generation (if enabled) adds ~$0.04 per article.

What’s next?