Skip to main content

​
Quick Redirect Implementation Guide

Generated: November 10, 2025
From: Google Search Console CSV analysis (719 noindexed URLs)

​
Summary

Your CSV data shows 360 redirects needed to fix broken URLs:
TypeCountPriority
Version folder redirects303🔴 CRITICAL
Release notes flat → nested30🟠 HIGH
Malformed nested paths26🟡 MEDIUM
Special cases1🟡 MEDIUM
TOTAL360

​
Quick Start: Add 3 Wildcard Redirects

Instead of adding 303 individual redirects, add these 3 wildcard redirects to your docs.json that will handle most cases: 
{
  "redirects": [
    // ... your existing redirects ...
    
    // === CRITICAL VERSION FOLDER REDIRECTS ===
    {
      "source": "/4.5.0/:path*",
      "destination": "/4.6.0/:path*"
    },
    {
      "source": "/5.0-tech-preview/:path*",
      "destination": "/5.1/:path*"
    },
    {
      "source": "/4.7.0/:path*",
      "destination": "/4.7.x/:path*"
    },
    
    // === MALFORMED NESTED PATHS ===
    {
      "source": "/release-notes/v5.x/5.1/:path*",
      "destination": "/5.1/:path*"
    },
    {
      "source": "/release-notes/5.0-tech-preview/:path*",
      "destination": "/5.1/:path*"
    },
    {
      "source": "/release-notes/docs/:path*",
      "destination": "/5.1/docs/:path*"
    },
    {
      "source": "/release-notes/v4.x/4.5.0/:path*",
      "destination": "/release-notes/v4.x/4.6.0/:path*"
    }
  ]
}
These 7 wildcards will fix ~330 of the 360 broken URLs ✅

​
Phase 2: Add Top Release Notes Redirects

Add these specific release notes redirects for commonly accessed pages: 
{
  "redirects": [
    // ... wildcards from above ...
    
    // === TOP RELEASE NOTES ===
    {
      "source": "/release-notes/v4.7.4-may-2025",
      "destination": "/release-notes/v4.x/v4.7.x-lts/v4.7.4-may-2025/v4.7.4-may-2025"
    },
    {
      "source": "/release-notes/v4.7.4-may-2025/",
      "destination": "/release-notes/v4.x/v4.7.x-lts/v4.7.4-may-2025/v4.7.4-may-2025"
    },
    {
      "source": "/release-notes/v3.4.0-september-2023",
      "destination": "/release-notes/v3.x.x/v3.4.0-september-2023/v3.4.0-september-2023"
    },
    {
      "source": "/release-notes/v3.4.0-september-2023/",
      "destination": "/release-notes/v3.x.x/v3.4.0-september-2023/v3.4.0-september-2023"
    },
    {
      "source": "/release-notes/v4.1.5-september-2024",
      "destination": "/release-notes/v4.x/v4.1.x/v4.1.5-september-2024/v4.1.5-september-2024"
    },
    {
      "source": "/release-notes/v4.1.5-september-2024/",
      "destination": "/release-notes/v4.x/v4.1.x/v4.1.5-september-2024/v4.1.5-september-2024"
    },
    {
      "source": "/release-notes/v4.0.0-april-2024",
      "destination": "/release-notes/v4.x/v4.0.0-april-2024/v4.0.0-april-2024"
    },
    {
      "source": "/release-notes/v4.0.0-april-2024/",
      "destination": "/release-notes/v4.x/v4.0.0-april-2024/v4.0.0-april-2024"
    },
    {
      "source": "/release-notes/v4.1.1-june-2024",
      "destination": "/release-notes/v4.x/v4.1.x/v4.1.1-june-2024/v4.1.1-june-2024"
    },
    {
      "source": "/release-notes/v4.1.1-june-2024/",
      "destination": "/release-notes/v4.x/v4.1.x/v4.1.1-june-2024/v4.1.1-june-2024"
    },
    
    // === SPECIAL CASES ===
    {
      "source": "/faqs",
      "destination": "/5.1/docs/introduction"
    }
  ]
}

​
Expected Results

​
Before Redirects

  • 719 noindexed pages in Google Search Console
  • 360 broken URLs causing 404 errors
  • Users hitting dead ends from bookmarks/search
  • Lost SEO value from backlinks

​
After Redirects

  • ~350-400 URLs successfully redirected (301 permanent)
  • ~320-370 fewer 404 errors
  • Preserved SEO value from external links
  • Better user experience

​
Remaining Noindexed (Expected)

  • ~320-370 pages will remain noindexed (correctly):
    • Malformed URLs from crawl errors ($2, runtime()
    • External demo systems (auth-*.demo.flowx.ai)
    • Old version docs not in navigation (intentional)
    • System endpoints (/health, /actuator)

​
Testing

​
Before Deploying

# Check docs.json is valid JSON
cd /Users/caravasiledragos/flowx-docs
cat docs.json | python -m json.tool > /dev/null && echo "✅ Valid JSON" || echo "❌ Invalid JSON"

​
After Deploying

# Test critical redirects
curl -I https://docs.flowx.ai/4.5.0/docs/introduction
# Expected: HTTP/1.1 301 Moved Permanently

curl -I https://docs.flowx.ai/5.0-tech-preview/setup-guides/spicedb
# Expected: HTTP/1.1 301 Moved Permanently

curl -I https://docs.flowx.ai/release-notes/v4.7.4-may-2025
# Expected: HTTP/1.1 301 Moved Permanently

​
Timeline

​
Week 1 (Immediate)

  • Fix internal broken links (35 links) ✅ DONE
  • Add 7 wildcard redirects to docs.json
  • Deploy to preview environment
  • Test redirects
  • Deploy to production

​
Week 2-3 (Short-term)

  • Add top 10 release notes redirects
  • Monitor Google Search Console
  • Request recrawl of fixed URLs

​
Month 2+ (Long-term)

  • Monitor redirect effectiveness
  • Add more specific redirects if needed
  • Clean up old redirects (after 6+ months)

​
Files Created

  1. REDIRECT-STRATEGY.md - Complete redirect strategy documentation
  2. scripts/generate-redirects-from-csv.js - Automated redirect generator
  3. REDIRECT-IMPLEMENTATION.md (this file) - Quick start guide

​
Next Steps

  1. Copy the wildcard redirects from the “Quick Start” section above
  2. Paste into your docs.json in the redirects array
  3. Test locally (validate JSON)
  4. Deploy to Mintlify preview environment
  5. Test redirects work correctly
  6. Deploy to production
  7. Monitor Google Search Console for improvements

​
Questions?

  • Full strategy → See REDIRECT-STRATEGY.md
  • Generate custom redirects → Run scripts/generate-redirects-from-csv.js
  • Broken internal links → Already fixed! ✅
  • Need help? → Check the main strategy doc first
Expected Impact: Fixes 330+ of 360 broken URLs with just 7 wildcard redirects! 🎉