Rewrite Suggestion Types
The complete catalog of SitePulse's 20 rewrite suggestion types — when each triggers, what it changes, and which GEO strategy it maps to.
SitePulse generates up to 20 distinct types of rewrite suggestions per audit. Each type targets a specific on-page element, maps to one or more scoring rubrics, and maps to a GEO improvement strategy. This page is the canonical reference for all 20 types.
How suggestion types are grouped
| Group | Types | Primary rubric |
|---|---|---|
| Core metadata | title, meta_description, heading_h1 | SEO |
| Media | image_alt | SEO + Accessibility |
| Structured data | structured_data, faq_schema, howto_schema | GEO + SEO |
| Content quality | content_suggestion, citation_block, structured_list, reading_level_fix, paragraph_split, stat_density, unique_phrasing | GEO + Content Quality |
| Links | link_text | SEO + Accessibility |
| Headings | heading_fix | GEO + SEO |
| Brand & voice | brand_voice_fix, quote_attribution, language_simplification | Content Quality |
| Keywords | keyword_optimization | SEO + GEO |
Core metadata
title
Triggers when: Title tag is missing, longer than 60 chars, shorter than 30 chars, starts with the site name, or doesn't include the primary keyword.
What it changes: Rewrites the <title> tag.
GEO strategy: add_keywords
Example:
- Original:
Acme Coffee Roasters — Our Blog — The Ultimate Guide to Single-Origin Espresso Beans and How to Choose - Suggested:
Single-Origin Espresso: How to Choose the Best Beans
meta_description
Triggers when: Meta description is missing, outside 70–160 chars, or identical to the title.
What it changes: Rewrites the <meta name="description"> content.
GEO strategy: ease_of_understanding
heading_h1
Triggers when: No H1 is present, multiple H1s exist, or the H1 doesn't match the page topic.
What it changes: Suggests the correct H1 text.
GEO strategy: add_keywords
Media
image_alt
Triggers when: One or more <img> elements have empty or missing alt attributes.
What it changes: Generates descriptive alt text for each flagged image.
GEO strategy: ease_of_understanding
Note: Alt text suggestions are generated per-image. Each flagged image produces a separate suggestion card.
Structured data
structured_data
Triggers when: No JSON-LD block is present, or existing JSON-LD is malformed or missing required properties.
What it changes: Generates or repairs a JSON-LD block. Defaults to Article type for blog/editorial content, WebPage for other pages.
GEO strategy: add_authority
faq_schema
Triggers when: The page contains question-and-answer content (detected via heading + paragraph pattern) but no FAQPage JSON-LD is present.
What it changes: Generates a FAQPage JSON-LD block from the detected Q&A content.
GEO strategy: cite_sources
Note: This is one of the highest-impact GEO improvements — FAQPage schema enables direct answer extraction by AI engines.
howto_schema
Triggers when: The page contains step-by-step instructions (numbered list or Steps pattern) but no HowTo JSON-LD is present.
What it changes: Generates a HowTo JSON-LD block from the detected steps.
GEO strategy: cite_sources
Content quality
content_suggestion
Triggers when: Content depth score is below threshold — typically thin pages (< 300 words) or pages with low entity density.
What it changes: Suggests a specific paragraph or section to add, including suggested content.
GEO strategy: add_statistics or ease_of_understanding
citation_block
Triggers when: The page makes factual claims (statistics, percentages, dates) without citing a source, or has fewer than 2 external links.
What it changes: Suggests adding attribution for specific claims, or adding authoritative external links.
GEO strategy: cite_sources
structured_list
Triggers when: A long prose paragraph could be expressed more clearly as a list, or the page has no lists at all.
What it changes: Rewrites the identified paragraph as a bulleted or numbered list.
GEO strategy: ease_of_understanding
reading_level_fix
Triggers when: Flesch Reading Ease score is below 50 (college-level difficulty) or average sentence length exceeds 25 words.
What it changes: Rewrites the specific sentence(s) flagged as too complex.
GEO strategy: simpler_language
paragraph_split
Triggers when: A paragraph exceeds 150 words, creating a wall-of-text pattern.
What it changes: Splits the paragraph at a logical boundary, optionally adding a sub-heading.
GEO strategy: ease_of_understanding
stat_density
Triggers when: Content quality score for "factual density" is low — page lacks specific numbers, dates, or measurable claims.
What it changes: Suggests where to add supporting statistics or data points.
GEO strategy: add_statistics
unique_phrasing
Triggers when: High vocabulary repetition detected — the same phrases appear more than 3 times in the body content.
What it changes: Suggests varied alternatives for over-used phrases.
GEO strategy: unique_words
Links
link_text
Triggers when: Links use generic anchor text ("click here", "learn more", "read more", "here").
What it changes: Rewrites the anchor text to be descriptive of the linked destination.
GEO strategy: ease_of_understanding
Headings
heading_fix
Triggers when: Heading levels are skipped (H2 → H4 without H3), headings are vague ("Introduction", "Overview"), or no headings are phrased as questions.
What it changes: Rewrites the specific heading to be more descriptive or question-form.
GEO strategy: add_keywords
Brand & voice
brand_voice_fix
Triggers when: Personas are configured and the content deviates from the target brand voice — detected via Vale lint rules and persona tone alignment scoring.
What it changes: Rewrites the flagged sentence or paragraph to match the brand voice.
GEO strategy: fluency
Note: Only generated when Personas are configured on the project.
quote_attribution
Triggers when: The page uses direct quotes or paraphrases expert opinion without attribution (detected via quotation marks and "according to" patterns without a source name).
What it changes: Adds or corrects the attribution with a named source.
GEO strategy: add_quotes
language_simplification
Triggers when: Technical jargon is used without explanation (detected via industry-specific term lists + context analysis).
What it changes: Adds a brief inline explanation, or rewrites using simpler terminology.
GEO strategy: simpler_language
Keywords
keyword_optimization
Triggers when: The primary topic keyword is not present in the first 100 words, or relevant secondary keywords are absent from headings.
What it changes: Rewrites the first paragraph or a heading to naturally include the target keyword.
GEO strategy: add_keywords
Persona relevance
When Personas are configured on your project, each suggestion card shows which personas benefit from the change. A suggestion that improves reading level, for example, shows badges for personas with a lower target reading level. This helps you prioritize — if your most important persona is a technical buyer, brand_voice_fix suggestions targeting that persona rank higher.
Suggestion count limits
SitePulse generates up to 5 suggestions per type per audit to keep the review workload manageable. If a page has 12 images with missing alt text, you'll see 5 image_alt suggestions — the most impactful 5, ranked by position and visibility.