Docs / Core SEO / On-Page SEO

On-Page SEO

Complete on-page optimization with the SEO metabox, content analysis engine, focus keywords, readability scoring, and bulk management tools.

The SEO Metabox

The SEO metabox () appears below the editor on every post, page, and custom post type. It provides real-time SEO analysis and optimization controls.

πŸ–ΌοΈ
SEO Metabox in Post Editor
Screenshot: Full metabox with all fields expanded β€” 900 Γ— 500px β€” assets/images/seo-metabox.png

Metabox Fields

FieldPost Meta KeyDescription
SEO Titleβ€”Custom title tag override. If empty, falls back to post title + separator + site name.
Meta Descriptionβ€”Custom meta description. If empty, auto-generated from first 160 chars of content.
Focus Keyword(s)β€”Primary keyword(s) for analysis. Stored as Tagify JSON. Multiple keywords with Pro.
SEO Scoreβ€”Computed score (0–100) based on content analysis checks.
Noindexβ€”When checked, adds <meta name="robots" content="noindex"> to the page.

SEO Title

The SEO title is the most important on-page ranking factor. It appears in search engine results as the clickable blue link.

πŸ’‘
Best Practices:
  • Keep titles between 50–60 characters
  • Include the focus keyword near the beginning
  • Use the title separator configured in General Settings
  • Make each title unique across your site

Title Placeholders

You can use dynamic placeholders in your title templates:

PlaceholderOutput
{site_name}Your WordPress site title
{site_desc}Your WordPress tagline
{title}Current post/page title
{sep}Title separator (default: |)

Meta Description

The meta description appears as the snippet text below the title in search results. While not a direct ranking factor, it significantly impacts click-through rates.

πŸ’‘
Optimal Length: 120–160 characters. The metabox shows a character counter with green/amber/red indicators. Descriptions longer than 160 characters may be truncated in SERPs.

Focus Keywords

Focus keywords drive the content analysis engine. Enter your target keyword(s) and the metabox will check multiple on-page factors.

πŸ–ΌοΈ
Focus Keyword Input (Tagify)
Screenshot: Tagify keyword input with multiple tags β€” 600 Γ— 100px β€” assets/images/focus-keywords.png
⭐
Pro Feature β€” Multiple Keywords: Free tier allows 1 focus keyword per post. Pro and Elite allow unlimited focus keywords with parallel analysis for each. Controlled by the multi_keyword feature gate.

Content Analysis Engine

The content analysis engine runs every time you save or update a post. It also runs in real-time as you type.

SEO Checks Performed

CheckWeightDescription
Keyword in TitleHighFocus keyword appears in the SEO title
Keyword in H1HighFocus keyword found in the first H1 heading
Keyword in URLMediumFocus keyword or variant present in the post slug
Keyword in First ParagraphMediumFocus keyword appears within the first 100 words
Keyword in Meta DescriptionMediumFocus keyword present in the meta description
Keyword DensityMediumKeyword appears 1–3% of total word count (optimal range)
Keyword in SubheadingsLowFocus keyword found in at least one H2/H3 heading
Image Alt AttributesLowAt least one image has alt text containing the focus keyword
Internal LinksMediumContent contains at least one internal link
External LinksLowContent contains at least one outbound link
Content LengthMediumMinimum 300 words (optimal: 1000+ for blog posts)
Title LengthMediumBetween 50–60 characters
Description LengthMediumBetween 120–160 characters
πŸ–ΌοΈ
Content Analysis Results Panel
Screenshot: Analysis checklist with pass/fail icons β€” 600 Γ— 400px β€” assets/images/content-analysis.png

Readability Score

The readability module analyzes your content's reading ease using the Flesch Reading Ease formula. It runs automatically when you edit a post.

ScoreLevelTarget Audience
90–100Very Easy5th grader
80–89Easy6th grader
70–79Fairly Easy7th grader
60–69Standard8th–9th grader (recommended for web content)
50–59Fairly Difficult10th–12th grader
30–49DifficultCollege student
0–29Very DifficultCollege graduate / professional

Readability results are stored in the table fields: readability_score, flesch_ease, word_count.

SERP Snippet Preview

The metabox includes a live Google SERP snippet preview that shows exactly how your page will appear in search results. It updates in real-time as you type your SEO title and meta description.

πŸ–ΌοΈ
Live SERP Snippet Preview
Screenshot: Google-style preview with title, URL, description β€” 600 Γ— 150px β€” assets/images/snippet-preview.png

Noindex / Nofollow Controls

Per-page robot directives can be set via the SEO metabox:

Global noindex settings are available in Settings:

Bulk SEO Manager

The Bulk SEO Manager (, slug: serpelo-bulk-manager) lets you view and edit SEO titles, descriptions, and robot directives for all posts in a spreadsheet-like interface.

πŸ–ΌοΈ
Bulk SEO Manager Table
Screenshot: Table view with inline editing β€” 1000 Γ— 500px β€” assets/images/bulk-manager.png

Features

Titles & Meta Settings

Global title and meta patterns are configured in Settings β†’ Titles & Meta (serpelo-titles).

SettingOption KeyDefault
Title Separatorβ€”|
Homepage Titleβ€”{site_name} | {site_desc}
Homepage Descriptionβ€”{site_desc}
Noindex Archivesβ€”0 (off)
Noindex Tagsβ€”1 (on)