SEO NEO
Version 1.x
Section last updated
SEO NEO version 1.x documentation — current release 1.1.3. 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.3. Start with the Quickstart ⭐ to install SEO NEO and ship an SEO-correct page in five minutes.
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.
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.