# 05 — SEO Plugin Compatibility

AgizoAI Publisher writes SEO metadata into common WordPress SEO plugin fields and also keeps its own internal `_agizpuai_*` metadata for reporting and future edits.

## Supported Modes

### Auto
Writes only to detected supported SEO plugins.

### All
Writes to all known common SEO meta keys. This is useful if you migrate between popular SEO plugins.

### Custom
Writes only to custom keys defined in settings.

### None
Only stores the plugin's own `_agizpuai_*` meta fields.

## Supported SEO Targets

Built-in compatibility focuses on widely used WordPress SEO plugins:

- Yoast SEO
- Rank Math SEO
- All in One SEO
- SEOPress
- The SEO Framework
- Squirrly SEO
- Custom SEO meta keys

## Custom Key Format

Go to **AgizoAI Publisher → Settings → SEO Plugin Compatibility**.

Example:

```text
title=_your_seo_title_key
description=_your_meta_description_key
focus=_your_focus_keyword_key
canonical=_your_canonical_key
robots=_your_robots_key
```

Multiple keys may be comma-separated:

```text
title=_key_one,_key_two
```

## Generated SEO Fields

- SEO title
- Meta description
- Focus keyphrase
- Secondary keyphrases / synonyms
- Canonical URL, if supplied
- Robots, if supplied
- Tags
- Excerpt
- Image alt text

## Secondary Keyphrases / Synonyms

The plugin also saves secondary keyphrases and synonyms.

Internal AgizoAI keys:

```text
_agizpuai_secondary_keyphrases
_agizpuai_secondary_keyphrases_json
```

Custom SEO meta mapping supports:

```text
secondary=your_meta_key
secondary_json=your_json_meta_key
focus_plus_secondary=your_combined_keyword_key
```

Use **Custom SEO Meta Keys** when a SEO plugin stores metadata in fields that are not covered by the built-in integrations.