AIOSEO ability reference

What AIOSEO needs before these load

2 of the 12 also ship in GoBuildWP Free 1.18.6 under the same names, marked “Also in GoBuildWP Free” below. They need no GoBuildWP Pro licence, but each retains its own dependency, feature and permission checks. Where Free's copy does less, its own description follows Pro's. When Pro's richer copy passes its gates, it registers first and answers.

All in One SEO 4.0 or newer must be active; the gate reads AIOSEO_VERSION, which both editions define. The Pro edition is recognised by aioseo()->pro. Term SEO needs Pro and answers aioseo_pro_required on the free edition, and the redirect calls register when Pro and its Redirect model are loaded. Every call uses GoBuildWP's permission check (manage_options, or super admin on multisite). With AIOSEO inactive the calls return aioseo_not_active, and a post whose type AIOSEO does not manage is refused with aioseo_invalid_post. Unlike Pro's writes, the free plugin's aioseo-edit-post-seo keeps a before-image of the AIOSEO columns it changes (title, description, robots), so rollback-change can restore them through AIOSEO's model while AIOSEO is active.

Minimum (base)

4.0 WPPILOT_PRO_AIOSEO_MIN_VERSION

AIOSEO editions

free, pro

Agent skills shipped

aioseo-integration

Robots in AIOSEO are all or nothing

Each AIOSEO row has a robots_default column. While it is true, every per-row robots flag is ignored and the post inherits the global or post-type setting, which the read reports as index default. Writing index default therefore resets all the flags and the preview limits together. If a request sets nofollow or a non-empty advanced list while leaving index at default, the module promotes the row to an explicit index so the override actually takes effect.

The advanced list takes noarchive, noimageindex, nosnippet, noodp and notranslate. The search preview limits are reported too: max_snippet and max_video_preview use -1 for unlimited, because AIOSEO stores null there, and 0 for none; max_image_preview defaults to large.

Why AIOSEO writes cannot be undone here

Post and term SEO sit in AIOSEO's aioseo_posts and aioseo_terms tables and redirects in aioseo_redirects, none of which the change ledger can snapshot, so every write made through GoBuildWP Pro's AIOSEO module, including its copy of aioseo-edit-post-seo, is logged as irreversible. Only the free plugin's aioseo-edit-post-seo, which answers when Pro is not active, captures the title, description and robots columns it changes so wppilot/rollback-change can write them back. Keep the output of the matching get call before editing: writing those values back is the way to reverse a change.

Text comes back through AIOSEO's own title sanitiser, so it matches what the page renders, and smart tags such as #post_title are left unexpanded. Redirect creates hash the source exactly as AIOSEO's save does and look it up across plain and regex rows, returning aioseo_redirect_exists (409) rather than a raw duplicate-key database error. Deleting a redirect also removes its row from aioseo_redirects_hits. Listing returns at most 500 rows per page.

Before accepting the result

Pro module rollback limits differ from Free’s supported per-post metadata exception. Pro writes to AIOSEO-owned tables are recorded as irreversible; check the exact writer rather than transferring Free recovery guarantees to all operations.

Safety profiles and human confirmation

Representative call sequence

This sequence describes the documented calls and checks to perform. It is not a recorded result from an installed WordPress site. Inspect returned errors and partial results, then verify the saved values and affected output before proceeding.

Leave a post indexable but stop search engines showing a text snippet for it.

1. 01 wppilot/aioseo-get-post-seo Shows robots.index as default, meaning the post currently inherits every robots setting from the site.
2. 02 wppilot/aioseo-edit-post-seo Sent robots with index set to index and advanced set to nosnippet, which switches the row to explicit robots so the nosnippet flag applies.
3. 03 wppilot/aioseo-get-post-seo Reads the post back to confirm the explicit index, the nosnippet token and the preview limits now stored.

Questions about AIOSEO