Internal Case Study

Shared component SEO markup upgrade

How shared tenant marketing components were upgraded to emit crawlable links and stronger FAQ semantics so improvements apply across sites that use the common registry.

Project Overview

The problem: JS-only interactions hid crawlable paths

Several shared marketing components relied on button click handlers for navigation and CTAs, which worked for users but created weaker crawlable-link behavior than real anchors for internal navigation and page discovery.

The goal was to improve SEO and accessibility semantics in shared components so all tenant sites using the common registry benefit without site-specific rewrites.

Replace JS-only navigation patterns with crawlable anchor links where possible
Keep smooth-scroll and existing interaction behavior
Apply fixes in shared variants instead of site-local forks
Improve FAQ accessibility semantics with aria relationships

Implementation Output

What changed in the shared component layer

2

Shared variant modules updated

0

Site-local forks required

6+

Common surfaces improved

A11y

FAQ aria relationships added

Implementation Steps

How the shared SEO markup upgrade was executed

A low-risk rollout focused on shared component semantics, crawlable links, and verification.

  1. 01

    Audit shared marketing variants

    Identified nav, CTA, footer, pricing, and FAQ patterns where JS-only interactions could be upgraded to better semantic HTML.

  2. 02

    Add shared action-to-anchor helpers

    Implemented shared helpers to derive href values while preserving smooth-scroll and click-enhanced behavior.

  3. 03

    Patch common variants

    Updated shared nav, hero CTA, services, footer, pricing, and FAQ variants so sites inheriting these components benefit automatically.

  4. 04

    Verify lint, SEO checks, and build

    Validated the changes with targeted linting, SEO validation, and a successful production build.

Notes & Learnings

Why this change matters

This case study focuses on shared technical quality improvements, not client-specific outcomes.

Want scalable improvements, not one-off patches?

Improve the shared components and your future pages get better too.

We can design and implement SEO-safe component improvements that strengthen your current site and future page rollouts.