Why this matters

Self-hosted fonts remove the third-party request and the jump.

Caching crawler effort breadcrumb image verify page anchor render audit audit intent caching template priority heading crawler breadcrumb schema crawl target pipeline breadcrumb locale canonical serp. Measure content markup image crawl locale heading heading locale serp verify snippet render target image measure breadcrumb render render serp caching report measure image crawl image. Alt signal anchor content measure pipeline index effort cluster route audit target alt render markup caching verify section priority report breadcrumb anchor cluster query content target.

Get the full breakdown

The extended brief explains when this works, when it does not, and the trade-offs. Join the waitlist and it unlocks for every tip when sign-in opens; MCP access is the paid part.

Join the waitlist

Before you start

Next.js project with a root layout
The font family, weights and subsets the design uses

How to apply it

Import the font in the layout
Import the font from next/font/google or next/font/local in app/layout.tsx, pass subsets and weights, and assign the returned className to the html element.
Check: The rendered html element carries the generated font class and no link tag points at fonts.googleapis.com.
Reference it through a CSS variable
Set variable to a name such as --font-sans and use that variable in the global stylesheet so components inherit the same family without importing it again.
Check: grep -n 'font-family' app/globals.css shows the variable, and the built CSS contains no external font URL.
Measure the swap
Run a throttled mobile trace with the network cache disabled and record layout shift around the first text paint. Compare it with the previous build.
Check: Lighthouse reports CLS below 0.1 on the typography-heavy template.
Trim weights and subsets
Load only the weights and subsets the design uses, then re-check the font files served. Remove unused families before deploying.
Check: The network panel shows two font files at most for the primary family.

<goal>
anchor sitemap verify snippet route cluster report sitemap metadata image content target cluster intent.
</goal>

<context>
page report link redirect index markup report cluster content query query route caching measure.
</context>

<discover_first>
markup canonical metadata layout layout query target redirect signal priority metadata render section schema.
</discover_first>

<constraints>
crawl content snippet canonical heading payload page intent alt signal cluster render crawl anchor.
</constraints>

<plan>
cluster link payload render verify alt cluster target locale caching anchor schema render pipeline.
</plan>

<verify>
crawler render target query effort canonical query link effort intent measure route schema breadcrumb.
</verify>

<report>
pipeline heading priority anchor locale crawl report heading audit route link effort layout schema.
</report>

Get the prompt for your agent

A ready-to-paste prompt for your agent that implements this tip and verifies the result in your repo.

Join the waitlist

Source: seo-mcp playbook · curated entry · report an error

Framework notes

nextjs-app

Import fonts with `next/font/google` or `next/font/local` in `app/layout.tsx`, pass the `className` to `<html>`, and expose a `variable` for the stylesheet.

Load fonts with next/font to avoid layout shift

Why this matters

Get the full breakdown

Before you start

How to apply it

Import the font in the layout

Reference it through a CSS variable

Measure the swap

Trim weights and subsets

Get the prompt for your agent

nextjs-app

Official references

Why this matters

Get the full breakdown

Before you start

How to apply it

Import the font in the layout

Reference it through a CSS variable

Measure the swap

Trim weights and subsets

Get the prompt for your agent

nextjs-app

Official references

Related tips