Guides

How to get complete SEO metadata onto your pages with Headlark, per framework and platform, plus the problems people usually come to us with. The docs are the short reference; these guides walk through a real setup.

Not sure what your site is missing? The free site checker lists duplicate titles, missing descriptions and broken link previews across up to 50 pages, with no account needed.

Integration guides

ViteAdd meta tags to a Vite build, with a real before and after. AstroThe Astro integration, or one command after astro build. Next.js static exportoutput: "export", the out folder and what to know about client navigation. NetlifyThe build plugin: one block in netlify.toml. WebflowA site token and a publish webhook. What gets written and what doesn't. Any site, with a script tagWhen you can paste code but can't change the build. Google only.

Common problems

Missing meta descriptions at scaleFind every page without one and fill them in from the page's own content. Open Graph tags for every pageWhy link previews come out blank and how to fix them for good. og:image not showing in Slack, LinkedIn or XThe usual causes, and a working og:image in Astro, Next.js and Hugo. Image alt text for SEO and accessibilityWhat alt text is for, and how Headlark fills in missing ones.

Docs sites: Docusaurus and Starlight

SEO for DocusaurusFront matter, the default preview image, noindex, the sitemap and trailing slashes. SEO for StarlightDescriptions, og:image through head, a Head override, the sitemap and hreflang. Duplicate titles and descriptions on a docs siteWhy Docusaurus, Starlight and VitePress repeat them, and how to find and fix them. JSON-LD for Astro and DocusaurusWhich schema.org types fit docs and blogs, with code and validation.

Comparisons (drafts)

Headlark vs SEOJuiceDraft, needs review. Headlark vs Webflow AI SEODraft, needs review. Headlark vs Alli AIDraft, needs review. Headlark vs writing it by handDraft, needs review.