SEO NEO
Version 1.x
Section last updated
SEO NEO version 1.x documentation — current release 1.1.9. Start with the Quickstart if you're new.
SEO NEO is a modern SEO module for ProcessWire. It uses native PW fields for every SEO value: meta title, description, canonical URL, Open Graph, Twitter cards, hreflang, robots directives, and JSON-LD structured data. Every field has full multi-language, selector, and import/export support out of the box.
Current release: 1.1.9. Start with the Quickstart ⭐ to install SEO NEO and ship an SEO-correct page in five minutes.
SEO NEO Pro adds companion modules for content editors, SEO professionals, and site managers: a frontend preview bar, field-mapping visualiser, redirects, and sitemaps. See SEO NEO Pro or Free vs PRO.
Introduction
Why SEO NEO
The case for SEO NEO over MarkupSEO and Seo Maestro: a modern, actively-maintained SEO module built on native ProcessWire fields.
Getting Started
A tour of what SEO NEO outputs: meta tags, Open Graph, Twitter cards, hreflang, robots, and JSON-LD — and how the fallback chain keeps most pages SEO-correct with no manual data entry.
Quickstart ⭐
Install SEO NEO and ship an SEO-correct page in five minutes.
Installation & Setup
Installation
Step-by-step install: requirements, copying the module folder, installing in the PW admin, adding the SEO tab to templates, basic configuration, and ProCache compatibility notes.
Configuration
A guided tour of every setting in Modules > Configure > SeoNeo, fieldset by fieldset: title format, injection, canonical policy, smart-map, Open Graph, Twitter, robots, verification, and JSON-LD.
Migrating from MarkupSEO or Seo Maestro
Field-name mapping, template API swap ($page->seo to $page->seoneo), running the migration script, testing, and uninstalling the legacy module.
Editor Experience
Output & Resolution
Smart-Map & Fallbacks
How SEO NEO resolves a value: per-page field, smart-map fallback, template default, site default — and how to configure each step.
Robots & Indexing
Per-page noindex/nofollow, site-wide auto-noindex for unpublished and hidden pages, granular Google directives (max-snippet, max-image-preview), and AI/LLM opt-out.
Open Graph & Twitter
What SEO NEO emits by default, the og:type=article rules, the four-step Open Graph image resolver, Twitter / X card behaviour, and locale handling.
Custom Meta Tags
Per-page custom HTML via seoneo_custom and global field-to-tag mappings in module config — when to use each, and how values are escaped.
Structured Data (JSON-LD)
Beta. The @graph SEO NEO emits — Organization, WebSite, WebPage, optional Article, Person, and BreadcrumbList — how it's wired, how to configure it, and how to extend or disable it.
Multilingual
Hreflang link generation with segment and pagination support, hreflang code map, Open Graph locale map, per-language site name, and multilingual JSON-LD Organization nodes.
Developer Reference
Template API
The flat surface ($page->seoneo->renderTitle(), ->ogTitle) and namespace surface ($page->seoneo->og->render(), ->hreflang->alternates) — value getters, partial renderers, and SeoMaestro migration tips.
Hooks & Customisation
Every resolver and render method in SEO NEO is hookable. addHookAfter / addHookBefore examples for title, description, og:type, robots directives, Twitter creator, and JSON-LD graph extension.
Reference
Other
Redirects
Manage 301, 302, and 410 redirects, triage 404s, import from CSV, and auto-create rules when page slugs change. Integrates with the SEO Preview Bar Links panel.
Sitemaps
Offline XML sitemap builder for large ProcessWire sites. Uses SEO NEO canonical URLs and noindex rules as the single source of truth for inclusion.
Field Mapping Visualiser
See where title and description values come from when smart-map fallbacks fill the gaps. Chain icon in the page editor, via labels on the SEO Preview Bar.
SEO NEO Pro
Pro companion modules for content editors, SEO professionals, and site managers who need tools beyond basic meta tags. A growing collection, added to over time.
SEO Preview Bar
View a page's resolved SEO data side by side with the page on the frontend. A toolbar and drawer for logged-in editors on the live site.
Free vs PRO
Free SEO NEO ships the full SEO output engine. PRO adds editor tooling, frontend inspection, redirects, sitemaps, and field-mapping visualisers.
Headings
H1–H6 outline and per-level summary badges on the frontend SEO Preview Bar for quick page structure checks.
Links
Internal link HTTP status checks, broken-link highlights, and optional Create redirect actions on the frontend SEO Preview Bar.
Schema
JSON-LD graph nodes, schema.org type links, and validator shortcuts on the frontend SEO Preview Bar.
Open Graph
OG card preview plus resolved Open Graph and Twitter / X fields on the frontend SEO Preview Bar, with optional Field Mapping chain labels.
Images
Alt and title audit for every img on the page, with file-type breakdown, on the frontend SEO Preview Bar.
SEO & Meta
SERP preview, resolved title and description, canonical, robots, hreflang, and quick links to robots.txt and sitemap.xml on the frontend SEO Preview Bar.