---
title: "Fix with AI - Serpwise Documentation"
description: "Generate rules, meta tags, and structured data for SEO audit issues and AI readiness recommendations with one click."
url: "https://serpwise.ai/docs/fix-with-ai/"
source: "https://serpwise.ai/docs/fix-with-ai/"
---
[Back to Serpwise](/)

Serpwise Documentation

Connect · Configure · Execute

Search documentation

`/`

No documentation found.

↑↓ Navigate Enter to open

Browse documentation

**Fix with AI** turns SEO audit issues and AI readiness recommendations into one-click fixes. Instead of manually creating rules or generating meta tags, the fix engine analyzes each issue, generates the correct configuration, and applies it - either as an edge rule or an AI meta override.

* * *

## How It Works

When Serpwise identifies an SEO issue or AI readiness gap, it maps the issue to a fix strategy from its built-in registry. Clicking **Fix with AI** on any fixable issue triggers this flow:

1. **Issue identified** - The [SEO Audit](/docs/seo-audit) or [AI Visibility](/docs/ai-visibility) tab flags a missing or suboptimal element (e.g., missing OG tags, no canonical URL, thin meta description).
2. **Fix preview** - A panel shows what the fix will do: the rule it will create, the conditions it will match, and the actions it will apply. You can choose **page-level** or **site-wide** scope.
3. **Apply** - One click creates the rule or triggers AI meta generation. The gateway begins serving the fix immediately after cache invalidation.

No manual rule building, no JSON editing, no engineering tickets.

* * *

## Fix Types

The fix engine supports three types of fixes, chosen automatically based on the issue:

### Rule-Based Fixes

For structural SEO elements that follow deterministic patterns. The engine generates a complete [rule](/docs/rules-overview) with conditions, actions, and scope - ready to apply.

| Issue                                                      | Fix Applied                                                                           |
|------------------------------------------------------------|---------------------------------------------------------------------------------------|
| Missing OG tags (title, description, URL, type, site name) | `set_meta_tag` actions using [dynamic variables](/docs/variables) like `{page_title}` |
| Missing Twitter Card tags                                  | `set_meta_tag` actions for `twitter:card`, `twitter:title`, `twitter:description`     |
| Missing canonical URL                                      | `set_canonical` action using `{full_url}`                                             |
| Missing viewport meta tag                                  | `set_meta_tag` for `viewport`                                                         |
| Missing charset declaration                                | `inject_html` at `head_start`                                                         |
| No structured data                                         | `inject_json_ld` with Organization schema                                             |
| Noindex directive blocking indexing                        | `set_meta_robots` to `index, follow`                                                  |

Rule-based fixes use [domain variables](/docs/variables) where possible (e.g., `{page_title}`, `{full_url}`), so a single site-wide rule works correctly across all pages.

### AI Meta Fixes

For meta titles and descriptions that need to be unique per page. Instead of a static rule, Fix with AI triggers [AI Meta Generation](/docs/ai-meta) for the specific URL:

| Issue                                  | Fix Applied                                            |
|----------------------------------------|--------------------------------------------------------|
| Missing meta title                     | AI generates an optimized title for this page          |
| Meta title too short or too long       | AI generates a title within best-practice length       |
| Missing meta description               | AI generates an optimized description for this page    |
| Meta description too short or too long | AI generates a description within best-practice length |

AI meta fixes cost **2 credits per URL** (same as standard [AI Meta Generation](/docs/ai-meta)).

### Manual Fixes

Some issues can only be resolved by changes on your origin server. These are flagged with guidance but cannot be auto-applied:

- Heading structure (H1 count, heading hierarchy)
- Content length and quality
- Image alt text and lazy loading
- Internal linking
- Structured data validation errors

* * *

## Page-Level vs. Site-Wide Scope

When applying a rule-based fix, you choose the scope:

| Scope         | Behavior                                                             |
|---------------|----------------------------------------------------------------------|
| **Page**      | Rule condition targets the specific URL path (e.g., `/blog/my-post`) |
| **Site-wide** | Rule condition matches all pages (`url.path starts_with /`)          |

For most structural fixes (OG tags, canonical, viewport), **site-wide** is recommended - it fixes every page at once. For page-specific issues (like removing a noindex directive on one page), use **page** scope.

* * *

## Triggering Fixes

Fix with AI buttons appear in two places:

### From the SEO Audit Tab

On any [URL Detail](/docs/pages-overview) page, the **SEO Audit** tab shows issues grouped by category. Issues with available fixes display a **Fix with AI** button next to the issue description. Click it to open the fix preview panel.

### From the AI Visibility Tab

The **AI Visibility** tab shows [page-level AI readiness](/docs/ai-visibility#page-level-ai-readiness). Recommendations that map to fixable issues (e.g., “Add Open Graph tags”, “Add structured data”) include a **Fix with AI** button. This works even if no SEO audit has been run - the fix engine uses its built-in registry to generate the correct rule.

* * *

## Batch Fixes

The [Site-Wide SEO Dashboard](/docs/seo-dashboard) offers batch fix capabilities. Instead of fixing issues page by page, you can:

1. View aggregated issues across all crawled pages
2. See how many pages each fix would affect
3. Apply fixes in bulk - a single rule creation can resolve the same issue across your entire site

* * *

## What Happens After Applying

When you apply a fix:

1. A new [rule](/docs/rules-overview) is created (for rule-based fixes) or an [AI meta generation](/docs/ai-meta) job is enqueued (for AI meta fixes)
2. The gateway cache is automatically invalidated
3. The fix takes effect on the next request through the gateway
4. Re-run the [SEO Audit](/docs/seo-audit) to verify the issue is resolved (re-audits are free)

[**SEO Audit Engine**  
→  
\
Understand the 50+ checks that trigger fix suggestions.](/docs/seo-audit)

[**AI Visibility Tracking**  
→  
\
AI readiness recommendations with one-click fixes.](/docs/ai-visibility)

[**AI Meta Generation**  
→  
\
How AI-generated meta titles and descriptions work.](/docs/ai-meta)

[**Rules Engine**  
→  
\
Learn about the rules that Fix with AI creates.](/docs/rules-overview)