Internal Link Rot: Articles Point to Renamed or Deleted Slugs
Half your internal links return 404 because you renamed slugs without redirects. Run linkinator or lychee in CI, add a redirects file, fail prebuild on dangling links.
#Content ops
Articles tagged with #Content ops
Canonical URL Points to the Wrong Page: Translations Canonicalize Back to English
ZH pages have a canonical link pointing at the EN version — Google deindexes the ZH variant. Per-page canonical from current URL, verify with curl + view-source.
FAQ Rich Result Missing From SERP Despite FAQPage JSON-LD on Page
Your article has FAQPage JSON-LD but Google never shows the FAQ rich result. Causes: wrong Question/Answer nesting, page noindex, mismatched heading text. Fix and re-test.
Hreflang Tags Misconfigured: Search Console Flags Errors Between EN and ZH
Hreflang URLs don't pair, wrong language codes (zh vs zh-CN), missing x-default. Auto-emit from translationKey, validate with hreflang.org, fix at the source.
Image Alt Text Missing in Bulk: Hundreds of Images, Zero Accessibility
Articles use img tags with no alt attribute — bad for accessibility, bad for image search, bad for AdSense quality signals. Audit, backfill, enforce via MDX lint.
Publish Date Stuck in 2023: Articles Look Stale Even After Real Refreshes
publishedAt never moves even when content is rewritten. Add updatedAt, use volatile for fast-moving topics, refresh dates only on substantial edits — not cosmetic ones.
Tag Archive Pages With Zero Articles: Empty Pages Bloat the Sitemap
Tag pages exist but have 0 published articles after cleanup. Audit tag usage, require minimum 1 article per tag, auto-deindex or 410 the empty archives.
Translation Pages Mismatched: EN Has 5 Sections, ZH Has 3
Solo edits drift EN and ZH apart — sections, code blocks, links diverge. Audit pairs by structure, diff bilingual content, and enforce translate-as-you-edit policy.
Redirect Map Grew to Thousands of Entries and Slows Builds
Your _redirects file is 3,000 lines. Builds are slower, crawlers chase chains, and nobody knows which rules are still needed. How to audit, collapse, and prune.
Related-Articles Widget Keeps Surfacing Near-Duplicate Pages
Your 'Related articles' module shows three near-identical posts on every page. Readers bounce, internal-link equity dilutes. How to detect, score, and de-duplicate.
Astro Incremental Content Update Without Full Rebuild
How to ship a single article update on an Astro site without rebuilding 3,000 pages: islands, on-demand rendering, content-layer hashing, and a hybrid workflow that scales.
Content Site Quarterly Review Cadence That Actually Catches Drift
A 4-hour quarterly review template that surfaces traffic drift, topical decay, and rank loss before they compound — with the exact questions, queries, and decision rules to use.
Content Site Staffing and Roles for Solo to 5-Person Team
What roles a content site actually needs at each size — solo, 2-person, 3-person, 5-person — and where to add the next hire to unblock growth instead of just adding cost.
Tutorial Screenshots Are Outdated
Last year's UI in screenshots, instructions don't match what the user sees — trust drops, bounce rate rises. Audit + version-stamp + quarterly refresh.
AI-Generated Content Lacks Unique Value
Articles read fine but rank nowhere, get AdSense rejected for "unoriginal content." "Unique value" is one of six concrete additions — examples, data, contrarian POV, original research.
Article Count Looks Big But Real Coverage Is Weak
"We have 800 articles!" — but 60% are bilingual duplicates, drafts, or thin redirects. Count what matters: unique, indexable, substantive URLs.
Bilingual Pages Drift Apart Over Time
English got updated 5 times, Chinese once. ZH version has outdated screenshots, broken cross-links, hreflang warnings. Audit drift, decide per pair, automate the sync.
Category Page Too Weak to Rank or Be Indexed
Category page is title + cards. Google sees navigation, not content. Add a 300-word editorial intro + curated "start here" + a take, and the category becomes a hub article.
Draft Pages Accidentally Published
Build deployed pages still marked `draft: true`. They got indexed with placeholder text. Audit, deindex, then add CI guards so it can't happen again.
Duplicate Titles Across Many Pages
Audit flags 80 pages sharing the same `<title>`. Usually template fallback, pagination, or bilingual collision. Make per-page title required and CI-enforced.
Homepage Cannot Distribute Authority Well
200 outbound links on the homepage = 0.5% boost per link. Cut to 30 well-chosen destinations; move long lists to dedicated index pages.
Internal Links Severely Uneven — A Few Pages Get Everything
Top 10 pages have 80% of internal links; 200 pages have 0–2. Audit + body-text linking + smart related-articles widget = rebalance one of the highest-leverage SEO actions.
Many Pages But Few Attract Impressions
500 articles, top 20 pages get 80% of impressions, the tail gets 0–5/month. Power-law is normal — dead tail is the bug. Validate keywords, fix intent + links.
Orphan Content Pages Drag Down Site Quality
Pages with zero internal inbound links earn nothing. Not just an indexing debt — a quality signal to Google. Detect + integrate or remove.
Search Console Sees Many Low-Value URLs
"Crawled — not indexed" balloons to thousands of `?sort=`, `?page=`, tag-combo URLs. Triage by source, block via canonical / robots / noindex; reclaim crawl budget.
Content Site Grew Fast But Looks Repetitive
100 articles in 3 months — same structure, same examples, same conclusion. Templated thinking, not AI per se. Diversify angle + slow down before publishing more.
Stale Articles Haven't Been Updated in Years
Half your articles are 3+ years old, referencing tools that changed dramatically. Refresh top-traffic stale articles with real edits (not date-bump tricks).
Too Many Tags Create Thin Archive Pages
800 tags, 600 with 1-2 articles each = 600 thin archive pages. Set minimum-article threshold, merge synonyms, noindex the rest.
Too Many Thin Pages Are Dragging Down a Content Site
500+ pages, Google considers most thin. Audit by word count + traffic, then tag each as expand / merge / noindex / 410. Cut the weakest 20-40%.
Topic Cluster Too Shallow to Rank for the Pillar
Pillar + 2 supporting articles isn't a cluster — it's a stub. Real clusters have 6-10+ supporting articles. Brainstorm sub-topics, ship steadily over months, link bidirectionally.
How to Design Content-Site Sections So They Scale
Practical taxonomy + URL design for content sites — section schemas, hub-page templates, and sitemap config that scales from 50 to 1000 articles.
Building a Markdown / MDX Content Site That Scales
Structure a Markdown / MDX content site to scale from 50 to 1000 articles. Includes Content Collections schema, component map, and link-check script.
Should a New Content Site Go Broad or Deep First
Depth-first vs breadth-first for a new content site, with a hub-stage decision rule, content plan template, and Search Console check.
Planning a Long-Tail Keyword Site From Day One
Design a long-tail content site so structure, slugs, and internal links scale from 1 to 500 articles. Includes content sheet template and slug enforcement.
When It Makes Sense to Add a Second Language
Decide bilingual go/no-go with Search Console signals, hreflang layout template, and a 30-article re-evaluation gate.
Using AI to Review and Improve Existing Articles
A repeatable workflow for using AI to audit and upgrade old articles — what to ask, what to ignore, and how to turn a backlog into a refresh queue.
Writing Your App Store Listing So People Actually Install
A practical 2026 guide to writing the App Store listing copy that drives installs — the name, subtitle, keywords, screenshots, and description that actually convert.
How to Avoid Content Duplication When You're Scaling Fast
Duplication kills indexing once you cross a few hundred articles. Here's the script-driven workflow to catch it before Google does.
How to Avoid Low-Quality AI-Generated Content
The specific signals that make AI-written articles read as low-quality, and the concrete edits that fix them — from a 2026 publisher's perspective.
Content Volume vs Quality — How to Balance Them on a Content Site
Volume buys coverage, quality buys rankings. Use this Search Console-driven decision flow and quality-floor checklist to choose the right move.
"Crawled — Currently Not Indexed" — What It Actually Means and How to Fix It
Google crawled your page and decided not to index it. The reasons are almost always quality, duplication, or authority — not technical. The real fix list.
Finding Content Gaps with AI — a Repeatable Workflow
A 2026 workflow for using AI to spot the articles your site should have but doesn't — using your own sitemap, Search Console data, and a topic pillar map.
When Google Won't Crawl Your New Pages — a Real Checklist
A real diagnostic checklist for when you publish content and Google ignores it. The order matters — start at the top.
Managing a Content Site After It Crosses 1,000 Articles
Sites past 1,000 articles need scripts, not willpower. Use this content-index generator, dupe scanner, and retire-shelf workflow to stay sane.
What to Do in the First 30 Days of a New Content Site
A realistic 30-day playbook for a brand-new content site: indexing, structure, the first 20 articles, and what to ignore.
Pillar and Cluster Pages — The Structure Google Rewards
Design pillar and cluster pages so Google understands your topical authority. Includes content schema, link-audit script, and pillar page template.
Running a Site-Wide Content Audit — A Repeatable Process
A quarterly content audit with concrete scripts: URL inventory, Search Console join, dead-page flags, dupe scanner, broken-link checker, and decision log.
Scaling Content with AI Without Tanking Quality
A practical 2026 framework for using AI to produce dozens of articles per month without triggering helpful-content penalties or losing the voice that makes the site work.
Setting a Publishing Cadence You Can Actually Keep
Pick a sustainable publishing cadence with a real 8-week measurement, batch workflow, and backlog-tracker script you can drop into your repo.
When (and How) to Refresh Old Articles for Traffic
Refresh only what's worth refreshing — with the Search Console query that finds position 8-20 articles, a refresh template, and re-indexing flow.