Skip to content
TruthVouch Docs

Auto-Fix Capability

Some GEO recommendations can be auto-fixed directly from TruthVouch. Auto-fixes handle the most common, low-risk improvements: structured data markup, answer blocks, and FAQ schema.

What Can Be Auto-Fixed

1. Product Schema Markup

Automatically generates schema.org Product JSON-LD for your product pages.

Includes:

  • Product name
  • Description
  • Pricing (if available)
  • Features (extracted from page content)
  • Images
  • Reviews (if you have them)

Impact: +8-12 points Risk: Very low (schema.org is widely supported) Time to deploy: 30 seconds

2. FAQ Schema Markup

Automatically generates FAQPage schema for FAQ sections.

Includes:

  • Question/answer pairs (extracted from FAQ content)
  • Proper schema.org FAQPage format
  • JSON-LD format

Impact: +5-8 points Risk: Very low Time to deploy: 1 minute

3. Organization Schema

Automatically generates Organization schema for company information.

Includes:

  • Company name
  • Logo
  • Contact information
  • Founding date
  • Social media links

Impact: +3-5 points Risk: Very low Time to deploy: 30 seconds

4. Answer Blocks

Automatically generates a summary/TL;DR box for the top of your page.

Extracts:

  • Main topic from H1 heading
  • Key points from first 2-3 paragraphs
  • Formats as bullet points or short paragraph

Impact: +3-5 points Risk: Low (requires review) Time to deploy: 2-3 minutes (includes review)

5. Article Schema

For blog posts, automatically generates Article schema markup.

Includes:

  • Title, description
  • Publication date
  • Author
  • Article body
  • Images

Impact: +4-6 points Risk: Very low Time to deploy: 1 minute

How Auto-Fix Works

Step 1: Review the Recommendation

Navigate to Brand Intelligence → GEO → [Audit] → Recommendations.

Find a recommendation marked “Auto-fixable” (lightning bolt icon).

Example:

Add Product Schema to /products/governance
Auto-fixable: Yes
Impact: +10 points
Effort: 1 click

Click Auto-Fix or Preview.

Step 2: Review the Generated Code

TruthVouch shows you the code it will generate:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "AI Governance Platform",
  "description": "Policy-as-code for LLM enforcement with sub-200ms latency",
  "price": "2499",
  "priceCurrency": "USD",
  "image": "https://...",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "47"
  }
}

Review for accuracy:

  • Does the product name match your actual product?
  • Is the description accurate?
  • Is the price correct?
  • Are the images appropriate?

Step 3: Make Edits (if needed)

Click any field to edit:

  • Product name: Change if TruthVouch extracted the wrong product
  • Description: Edit if it’s inaccurate or incomplete
  • Price: Update if it’s changed
  • Image: Select a different image
  • Rating: Remove if you don’t have customer reviews

Step 4: Copy the Code

Click Copy Code to get the JSON-LD script.

Step 5: Add to Your Website

Paste the code into your page’s <head> section or just before </body>:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  ...
}
</script>

For technical teams: The code is valid JSON-LD and can be added to your CMS, static site generator, or template.

Step 6: Verify with Google Schema Validator

Test the code before deploying:

  1. Go to Google’s Schema Validator
  2. Paste your page HTML (including the JSON-LD)
  3. Check for errors (there should be none)
  4. Deploy to production

Step 7: Confirm in Dashboard

Return to TruthVouch and click Mark as Deployed to track the fix.

FAQ Schema Auto-Fix Example

Your FAQ Page

Q: What is GEO?
A: Generative Engine Optimization is the practice of optimizing
your website for AI systems...


Q: How long does a GEO audit take?
A: Most audits complete in 5-30 minutes depending on site size.

Auto-Generated Schema

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is GEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Generative Engine Optimization is the practice of optimizing..."
      }
    },
    {
      "@type": "Question",
      "name": "How long does a GEO audit take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Most audits complete in 5-30 minutes depending on site size."
      }
    }
  ]
}

You Can:

  • Edit answer text if it’s not quite right
  • Add/remove Q&A pairs
  • Reorder questions

Organization Schema Auto-Fix Example

Your Company Info

Auto-Generated Schema

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "TruthVouch",
  "logo": "https://truthvouch.com/logo.png",
  "foundingDate": "2020",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+1-...",
    "contactType": "Customer Service"
  },
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "...",
    "addressLocality": "San Francisco",
    "addressRegion": "CA",
    "postalCode": "...",
    "addressCountry": "US"
  }
}

Bulk Auto-Fix

For multiple auto-fixable recommendations:

  1. Navigate to Recommendations
  2. Filter by Type: Auto-fixable
  3. Check the boxes for recommendations you want to apply
  4. Click Bulk Auto-Fix
  5. Review all generated code
  6. Click Generate Package to get a single HTML/JavaScript file
  7. Deploy the file to your website

Typical result: +20-40 points by auto-fixing all quick wins at once.

Risk Mitigation

Auto-fix is designed to be low-risk:

  • No content changes: Schema markup is invisible to users, doesn’t change your page
  • Standard format: All generated code follows schema.org standards
  • Review required: You review the code before deploying
  • Easy rollback: If something goes wrong, delete the script tag
  • Third-party tools: Google, Bing, and other AI systems understand the markup

Common Auto-Fix Issues

”The generated product name is wrong”

Edit it before deploying. Click the name field and change it.

”I don’t have a product price to add”

Leave the price field empty in the schema. Remove the "price" line entirely.

”My FAQ answers are too long”

Schema FAQPage works with answers of any length, but shorter is better for AI systems. Edit before deploying.

”Generated code has an error”

Report the error and we’ll fix it. Click Report Issue in the auto-fix UI.

Testing Auto-Fixes

After deploying auto-fix code:

  1. Use Google’s Schema Validator to verify the markup
  2. Check with Yandex Rich Results Tool (backup validator)
  3. Wait 24-48 hours for Google to crawl and process
  4. Re-audit your page in TruthVouch to see the impact

Next Steps