Plugin Compatibility

wp-seo-ops is plugin-agnostic at the command level. You use the same command names regardless of which supported SEO plugin is active.

Supported Plugins

Plugin	WordPress Slug	Metadata Support	Redirect Support
Yoast SEO	wordpress-seo	Yes	Import/export formats only
SEOPress	wp-seopress	Yes	Import/export formats only
Rank Math SEO	seo-by-rank-math	Yes	Yes
AIOSEO	all-in-one-seo-pack	Yes	No direct redirect table support currently
Slim SEO	slim-seo	Fallback-oriented	No direct redirect table support currently
No plugin	none	Generic fallback keys	No direct redirect table support currently

Metadata Field Mapping

Commands use normalized fields:

seo-ops meta get 123 title
seo-ops meta get 123 description
seo-ops meta get 123 canonical

The adapter maps those fields to plugin-specific keys.

Example mappings:

Normalized Field	Yoast Example	SEOPress Example	Rank Math Example
title	_yoast_wpseo_title	_seopress_titles_title	rank_math_title
description	_yoast_wpseo_metadesc	_seopress_titles_desc	rank_math_description
canonical	_yoast_wpseo_canonical	_seopress_robots_canonical	rank_math_canonical_url
focus_keyword	_yoast_wpseo_focuskw	_seopress_analysis_target_kw	rank_math_focus_keyword

tip

Use normalized field names in scripts. Do not hardcode plugin meta keys unless you are intentionally bypassing the adapter.

Plugin Detection

Plugin detection checks active WordPress plugins through WP-CLI. You can confirm detected state with:

seo-ops inventory --path=/var/www/html

If the detected plugin is wrong, verify the plugin is active:

wp plugin list --path=/var/www/html

Migration Considerations

When changing SEO plugins:

1. Export metadata before the migration.
2. Activate and configure the new SEO plugin.
3. Confirm plugin detection with inventory.
4. Run meta import or meta bulk in dry-run mode.
5. Apply updates in small batches.
6. Run audit meta-check after migration.

Example:

seo-ops meta export --path=/var/www/html --output=before-plugin-change.csv
seo-ops inventory --path=/var/www/html
seo-ops meta import before-plugin-change.csv --path=/var/www/html --dry-run
seo-ops meta import before-plugin-change.csv --path=/var/www/html
seo-ops audit meta-check --path=/var/www/html --format=table

Redirect Compatibility

Redirect commands currently focus on plugins with accessible redirect storage support.

Plugin	Direct list/add/delete/import/export
Redirection	Yes
Rank Math SEO	Yes
Other plugins	Format import/export may be supported, direct storage may not be

For unsupported redirect plugins, use CSV export/import as an interchange format and test in staging first.

Fallback Keys

When no supported SEO plugin is active, wp-seo-ops can use generic keys such as _seo_ops_*.

Fallback mode is good for operational storage, but search engines will only see fallback metadata if your theme, SEO plugin, or custom code outputs those values into the page HTML.