Technical SEO & AEO Fix Checklist — Wisedocs.ai
Prepared for: Wisedocs Date: 2026-03-09 Scope: 414 indexed pages, 100 deeply audited Current Scores: Technical SEO 42/100 | AEO Readiness 65/100
This is an actionable, prioritized checklist for fixing every technical SEO and AEO issue identified on wisedocs.ai. Each item includes the exact fix, affected pages, estimated effort, and expected impact. Items are ordered by impact-to-effort ratio.
Priority 1 — Homepage H1 Tag (30 minutes)
Severity: CRITICAL | Impact: High | Pages affected: 1
The homepage (wisedocs.ai/) has no H1 tag. The first heading element on the page is an H2. This suppresses keyword relevance for every head term Wisedocs should rank for on the highest-authority page on the site.
- [ ] Add a single
<h1>tag above the fold onwisedocs.ai/ - [ ] Recommended H1:
AI Claims Document Processing PlatformorAI Medical Record Review Platform(match primary keyword target) - [ ] Verify the H1 is the first heading element on the page (no H2 before it)
- [ ] Confirm in Webflow that the hero headline component uses an H1 tag, not a styled div or span
Webflow implementation: Edit the Homepage hero section. Change the headline element from its current tag (likely a div with styled text or an H2) to an H1. One field change in the Webflow designer.
Priority 2 — Render-Blocking Scripts (1-2 week sprint)
Severity: CRITICAL | Impact: High | Pages affected: All 414
Every page loads an average of 33 JavaScript files, with 8-10 render-blocking scripts in <head>. Average inline JavaScript per page: 23,043 bytes. This directly suppresses Core Web Vitals (LCP, FID, INP).
- [ ] Audit all
<script>tags in<head>— identify which are critical-path vs. deferrable - [ ] Add
deferorasyncattribute to all non-critical scripts - [ ] Move GTM/analytics initialization out of
<head>or adddefer - [ ] Externalize inline JS (currently ~23KB per page) into cached files
- [ ] Add
Cache-Control: public, max-age=31536000, immutableheaders for static assets (JS, CSS, images) - [ ] Convert all images to WebP or AVIF format (99% of pages use legacy JPEG/PNG)
- [ ] Target: fewer than 3 render-blocking resources per page
- [ ] Validate with Google PageSpeed Insights after changes — target LCP under 2.5s
Webflow implementation: Most script loading can be controlled in Webflow's Project Settings > Custom Code section. Third-party scripts (analytics, chat widgets, tracking pixels) should use defer. Webflow's native scripts cannot be deferred but are already optimized. Image format conversion is available in Webflow's asset manager (enable WebP auto-conversion).
Priority 3 — Structured Data Implementation (1 week)
Severity: CRITICAL | Impact: High | Pages affected: 99 of 100 audited pages have zero schema
Only 1 page has any structured data, and that schema is malformed. This makes Wisedocs invisible to rich results, AI Overviews, and knowledge graph extraction.
Article Schema (blog posts)
- [ ] Add
ArticleJSON-LD to all blog posts (estimated 50+ pages) - [ ] Required properties:
@type,headline,author(with@type: Person),datePublished,dateModified,image,publisher(with@type: Organization) - [ ] Implementation: Add a JSON-LD script block to the Webflow CMS blog template that pulls from CMS fields
Template JSON-LD for blog posts:
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "{{Blog Post Title}}",
"author": {
"@type": "Person",
"name": "{{Author Name}}"
},
"datePublished": "{{Publish Date}}",
"dateModified": "{{Last Modified Date}}",
"image": "{{Featured Image URL}}",
"publisher": {
"@type": "Organization",
"name": "Wisedocs",
"logo": {
"@type": "ImageObject",
"url": "https://wisedocs.ai/logo.png"
}
}
}
FAQPage Schema
- [ ] Add
FAQPageJSON-LD towisedocs.ai/success-stories(has Q&A heading patterns) - [ ] Add
FAQPageJSON-LD to any product page with FAQ sections - [ ] Each question-answer pair maps to
mainEntityarray items with@type: Question
Template JSON-LD for FAQ pages:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Question text here",
"acceptedAnswer": {
"@type": "Answer",
"text": "Answer text here"
}
}
]
}
BreadcrumbList Schema
- [ ] Add
BreadcrumbListto 36 missing eligible pages: - [ ] All
/role/pages:/role/medical-evaluators,/role/claims-legal,/role/claims-adjusters,/role/defense-lawyers,/role/medical-assessor - [ ] All
/business-models/pages:/insurance-carriers,/tpas-case-management,/government-public-sector,/legal-claims - [ ] All
/product/pages missing it (including/product/medical-chronologies) - [ ] Blog index:
/blog-main-page - [ ] Implementation: Add BreadcrumbList JSON-LD to Webflow's page-level custom code or as a global template with dynamic path rendering
Organization Schema Fix
- [ ] Fix the homepage "Unknown" schema type — validate current JSON-LD at Google Rich Results Test
- [ ] Ensure
@type: Organizationwith all required properties - [ ] Add Organization schema to the About page (
wisedocs.ai/about) — currently only on homepage
Speakable Schema
- [ ] Add
Speakableschema to homepage and top 5 product pages - [ ] Target the most concise, quotable paragraphs on each page for the
cssSelectorproperty
Priority 4 — Title Tags and Meta Descriptions (2-3 days)
Severity: HIGH | Impact: CTR improvement | Pages affected: 63 titles, 66 descriptions
Titles exceeding 60 characters (63 pages)
- [ ] Audit all 63 pages with titles over 60 characters
- [ ] Rewrite each to 50-60 characters with primary keyword in the first 30 characters
- [ ] Worst offenders (rewrite first):
- [ ] 118 chars:
/blogs/axis-administrative-services-leverages-wisedocs-to-optimize-document-processing-workflows - [ ] 104 chars:
/blogs/bringing-empathy-back-to-claims-with-ai-human-in-the-loop-webinar - [ ] 101 chars:
/blogs/eighth-annual-insurtech100-recognizes-wisedocs - [ ] 101 chars:
/blogs/generative-ai-companies-modernizing-insurance-insurtech - [ ] Set a CMS-level character limit on the SEO Title field in Webflow to prevent future violations
Descriptions exceeding 160 characters (66 pages)
- [ ] Audit all 66 pages with descriptions over 160 characters
- [ ] Rewrite each to 120-155 characters with a clear value proposition and CTA
- [ ] Worst offenders (rewrite first):
- [ ] 343 chars:
/blogs/automating-claims-processing-how-wisedocs-handles-more-than-just-medical-records - [ ] 329 chars:
/blogs/connor-atchison-awarded-as-most-outstanding-entrepreneur-in-insurtech - [ ] 324 chars:
/blogs/5-steps-to-build-a-strong-rfp-for-ai-claims-document-management - [ ] 317 chars:
/blogs/how-certified-life-care-planners-can-use-artificial-intelligence-to-support-claims - [ ] Also fix 10 pages with descriptions under 120 characters (too short)
Priority 5 — Image Alt Text (1 week)
Severity: HIGH | Impact: Accessibility + image search + AI parsing | Pages affected: All 100 audited
657 images are missing alt text across the audited pages. This is both an accessibility compliance issue and an SEO signal loss.
- [ ] Fix homepage alt text (28 images missing)
- [ ] Fix blog index alt text (30 images missing — highest count)
- [ ] Fix remaining blog post images (varies, typically 3-10 per post)
- [ ] Fix product page images
- [ ] Set Webflow CMS image field to require alt text for all new uploads
- [ ] Alt text guidelines: descriptive, keyword-relevant where natural, not keyword-stuffed. Example: "Medical record chronology showing organized timeline of patient treatment dates" not "AI medical record review software chronology"
Priority 6 — Broken Links and Mixed Content (1 day)
Severity: CRITICAL (security) | Impact: Trust + crawl health | Pages affected: 41 source pages
Broken internal link (1)
- [ ] Fix the broken internal link on
/blogs/1-in-3-insurance-agencies-plan-to-implement-ai - Current broken URL uses
http://protocol pointing to/blogs/inside-the-buyers-guide-to-claims-documentation-platforms-security-and-compliance-primers - Update to correct HTTPS URL or remove if the target page no longer exists
Mixed content (3 pages)
- [ ] Fix
/blogs/1-in-3-insurance-agencies-plan-to-implement-ai— 2 HTTP references - [ ] Fix
/blogs/ags-rehab-solutions-automates-medical-record-insurance-claims-workflows— 1 HTTP reference - [ ] Fix
/blogs/eighth-annual-insurtech100-recognizes-wisedocs— 1 HTTP reference - [ ] Update all embedded resource references from
http://tohttps://
Broken external links (60 across 41 pages)
- [ ] Remove or replace links to defunct domains:
- [ ]
browngirladulting.com(404) - [ ]
balablabs.com(404) - [ ]
skeletonkrewagency.com(404) - [ ]
emedicolegal.com(404) - [ ]
rfpverse.com(404) - [ ] Verify McKinsey.com and BusinessWire links (likely bot-blocking, not true 404s — test manually)
- [ ] Set up a quarterly broken link audit process
Priority 7 — Multiple H1 Tags on Blog Posts (1-2 days)
Severity: WARNING | Impact: Topical signal dilution | Pages affected: 25 blog posts
25 blog posts have 2-7 H1 tags. This is a Webflow CMS template issue where section headings are styled as H1 instead of H2/H3.
- [ ] Fix at the CMS template level: ensure the blog post title is the only H1; all section headings use H2 or H3
- [ ] Worst offenders to check first:
- [ ]
/blogs/artificial-intelligence-in-healthcare— 7 H1s - [ ]
/blogs/ai-streamlines-demand-packages-bill-of-particulars— 6 H1s - [ ]
/blogs/faster-ai-medical-review-summaries— 6 H1s - [ ]
/blogs/case-management-challenges-in-insurance— 6 H1s - [ ] After template fix, verify that existing posts inherit the corrected heading hierarchy
Priority 8 — Publication Dates on All Content (1 day)
Severity: HIGH | Impact: AEO freshness scoring | Pages affected: All content pages (0% currently show dates)
Zero audited pages show visible publication dates. AI answer engines deprioritize content they cannot date.
- [ ] Add visible
<time datetime="YYYY-MM-DD">Published: [date]</time>element to all blog posts - [ ] Add visible dates to case studies and reports
- [ ] Add
<lastmod>dates to all sitemap entries (Webflow sitemap template setting) - [ ] Implementation: Add a date field to the blog post CMS template that renders as a visible
<time>element
Priority 9 — Open Graph and Twitter Card Tags (2-4 hours)
Severity: MEDIUM | Impact: Social sharing quality | Pages affected: All 414
100% of pages are missing og:url and all Twitter Card meta tags.
- [ ] Add
og:urlto global page template (set to canonical URL) - [ ] Add
twitter:cardmeta tag (value:summary_large_image) - [ ] Add
twitter:titlemeta tag - [ ] Add
twitter:descriptionmeta tag - [ ] Add
twitter:imagemeta tag - [ ] Implementation: All can be added in Webflow's global
<head>custom code with dynamic CMS field references
Priority 10 — llms.txt Optimization (2-4 hours)
Severity: MEDIUM | Impact: AEO discoverability | Pages affected: 1 file
The current llms.txt exists (ahead of most competitors) but is missing key elements and is excessively long at ~117K tokens.
- [ ] Add the
>blockquote description field near the top of llms.txt (required by spec) - [ ] Create
llms-full.txtatwisedocs.ai/llms-full.txtfor comprehensive AI ingestion - [ ] Reduce llms.txt to under 10K tokens — keep only the highest-value pages and descriptions
- [ ] Structure: Company description > Core product pages > Key use case pages > Top blog posts
Priority 11 — Content Structure for AI Parsing (ongoing)
Severity: MEDIUM | Impact: AEO citation eligibility | Pages affected: 90% of content pages
90% of pages lack lists, tables, or summary blocks — all formats that AI answer engines prefer to extract and cite.
- [ ] Add at least one bulleted or numbered list to every blog post
- [ ] Add TL;DR / Key Takeaways summary sections to all long-form content
- [ ] Add comparison tables to product pages and buyer's guide content
- [ ] Improve semantic HTML: use
<article>,<main>,<aside>tags to help AI distinguish content from navigation - [ ] Reduce content-to-code ratio (currently 22.8/100) by cleaning up nested Webflow div structures where possible
Scoring Targets
Completing Priorities 1-8 should move the scores to:
| Category | Current | Target (after fixes) |
|---|---|---|
| Technical SEO | 42/100 | 70-75/100 |
| AEO Readiness | 65/100 | 80-85/100 |
| On-Page SEO | 48/100 | 75-80/100 |
| Structured Data | 12/100 | 70-80/100 |
| Page Speed Signals | 25/100 | 55-65/100 |
| Citation Optimization | 35/100 | 60-70/100 |
Timeline
| Sprint | Items | Duration | Dependencies |
|---|---|---|---|
| Week 1 | Priority 1 (H1), Priority 6 (broken links), Priority 8 (dates), Priority 9 (OG tags), Priority 10 (llms.txt) | 2-3 days | None — all independent |
| Week 2 | Priority 4 (titles/descriptions), Priority 7 (H1 duplicates) | 3-4 days | None |
| Week 3-4 | Priority 2 (render-blocking JS), Priority 5 (alt text) | 7-10 days | May need dev support for JS audit |
| Week 3-4 | Priority 3 (structured data) | 5-7 days | Parallel with above |
| Ongoing | Priority 11 (content structure) | Continuous | Editorial process change |
Total estimated timeline: 4-6 weeks for Priorities 1-10. Priority 11 is an ongoing editorial standard.
How This Was Made
- Gemini Deep Research handled the initial broad research sweeps — competitive landscape, SERP analysis, market positioning. It synthesizes large amounts of web data quickly, which made it the right tool for the discovery phase.
- Claude (Anthropic) powered the specialized analysis agents. Each audit — technical SEO, content gaps, website messaging, social presence, paid ads, email nurture, pricing, review mining, keyword landscape, SERP competition — was run by a purpose-built agent with a specific evaluation framework.
- Every finding was human-reviewed. All agent outputs were presented through a custom review application where Jono reviewed each finding individually — starring high-value signals, keeping relevant ones, reworking those that needed refinement, and discarding those that missed the mark.
- The deliverable itself was drafted by a writing agent, then reviewed against the approved findings and brand standards by a reviewer agent. Jono made the final editorial decisions.
- The proposal site, design system, and all tooling were built by Claude Code.
AI-native workflows let one person do what agencies need teams for. The AI does the heavy lifting. The human makes every judgment call.