Skip to content

Stop flagging a blank seo_title when the article title covers it - #196

Merged
ssavutu merged 1 commit into
mainfrom
fix/seo-audit-title-fallback
Aug 6, 2026
Merged

Stop flagging a blank seo_title when the article title covers it#196
ssavutu merged 1 commit into
mainfrom
fix/seo-audit-title-fallback

Conversation

@ssavutu

@ssavutu ssavutu commented Aug 6, 2026

Copy link
Copy Markdown
Member

Problem

The SEO audit warned "Missing SEO title" whenever the seo_title column was empty. But blank is the normal, working state: the public site renders the article title in its place (Scalene ArticleLayout.astro:63), and the editor previews the same fallback — its input placeholder even says "Defaults to the article title." Nothing ever persists that default, so the column stays empty and the page still ships a correct <title>.

The result was a warning firing on articles whose output was already fine — essentially the whole legacy WordPress import. At ~1,900 total issues it buried the error-level findings (missing meta description, missing featured image) that do reflect broken output.

Change

Resolve the effective title the way the renderer does, then audit that:

  • Blank seo_title + a usable article title → no longer reported.
  • The 60-character check now runs against the effective title, so an over-long headline on an article with no explicit SEO title is caught. This is new behavior — a few long-headline articles that were previously silent will start showing this warning. Intended: that truncation is real in SERPs.
  • "Missing SEO title" survives only when there is neither, which is a genuinely broken <title>.

Testing

TestAuditArticleFallsBackToTitleForSEOTitle covers all three branches. Package tests and go vet pass.

Notes

The 49-error count on the dashboard won't move — this only touched a warning. What drops is the 1,932 total. I haven't measured the new number against prod; happy to run that count if it's worth knowing before merge.

🤖 Generated with Claude Code

The SEO audit read the seo_title column directly and warned whenever it
was empty. But a blank seo_title is not a defect: the public site renders
the article title in its place (Scalene ArticleLayout.astro), and the
editor's preview does the same. The page ships a correct <title> either
way, so the warning fired on articles whose output was already fine --
essentially the entire legacy WordPress import, which never had the
column populated. At ~1,900 issues it buried the error-level findings
that do reflect broken output.

Resolve the effective title the way the renderer does, then audit that.
A blank seo_title with a usable title is no longer reported, and the
60-character check now runs against the fallback, catching over-long
headlines that get truncated in search results but were previously
silent.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ssavutu
ssavutu merged commit 42772a2 into main Aug 6, 2026
6 checks passed
@ssavutu
ssavutu deleted the fix/seo-audit-title-fallback branch August 6, 2026 07:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant