> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: About SEO Support

## Article: About SEO Support

## Article Link: https://dev.wix.com/docs/go-headless/wix-managed-headless/seo/about-seo-support.md

## Article Content:

# About SEO Support

Wix-managed headless projects built with the [Astro integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/authentication/about-the-astro-integration.md) include a full set of SEO features. Wix generates SEO tags from the settings a Wix user edits in the dashboard, including:

- Titles
- Meta descriptions
- Canonical links
- Social tags
- Robots directives
- Structured data

## Page types

How a page gets its SEO depends on what kind of page it is:

- **Main pages** live at a single, fixed URL, such as your home, about, or contact page. Main pages get their SEO automatically, with no code.
- **Item pages** render one business-solution item from a parameterized route, such as a product at `/product/[handle]`, a blog post at `/blog/[slug]`, or a single category that lists the items in it. SEO support for item pages require code, since Wix can't resolve an item's tags until it knows which item the request is for.

> **Note**: A listing page is a main page too, even when it shows business-solution content. For example, an all-products page or a blog index is still one fixed URL.

## What works out of the box

Wix's Astro middleware resolves the SEO tags for each main page at request time, based on the dashboard settings, and injects them into the page `<head>`. There's nothing to install, register, or render. Each injected tag carries a `wix-seo-tag="true"` attribute, so you can recognize it in the rendered HTML.

A Wix user controls these tags in the dashboard, under **SEO & GEO** > [**SEO Settings**](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Fseo-home%2Fseo-settings):

- **Settings for main pages**: The title tag, meta description, focus keyword, and indexability of each main page. Each page's advanced settings also cover canonical links, custom meta tags, and structured data.
- **Social share**: The social tags used when a page is shared, such as Open Graph and Twitter.
- **Robots.txt editor**: The contents of `robots.txt`.

Wix serves `robots.txt` and `sitemap.xml` automatically. The sitemap includes your main pages and any item-page URLs from the page registry. Because the tags come from the dashboard, a Wix user can change a main page's SEO without a code change or a redeploy.

To set this up and verify it on your live site, see [Manage SEO for Main Pages](https://dev.wix.com/docs/go-headless/wix-managed-headless/seo/manage-seo-for-main-pages.md).

<blockquote class="tip">

**Tip:** Keep each tag in one place. For main pages, let the dashboard own the title, meta description, canonical link, and social tags, and don't set those same tags in your layout.

</blockquote>

## What you build in code

Automatic injection covers main pages only. Anything that depends on which item a request is for, or on data your frontend fetches, you render yourself.

- **Item pages**: The item pages of [business solutions](https://dev.wix.com/docs/go-headless/project-guides/featured-business-solutions.md), such as [Wix Stores](https://www.wix.com/app-market/web-solution/wix-stores) products, [Wix Bookings](https://www.wix.com/app-market/web-solution/bookings) services, [Wix Events](https://www.wix.com/app-market/web-solution/events), and [Wix Blog](https://www.wix.com/app-market/web-solution/wix-blog) posts, plus their category pages. You register each route and render its tags in code using the [`@wix/seo`](https://www.npmjs.com/package/@wix/seo) package. Registering a route also adds it to the page registry, which feeds the sitemap and the dashboard's SEO settings for that page type. As with main pages, a Wix user sets the actual tag values in the dashboard.
- **Custom structured data**: schema.org JSON-LD you build from an item's data. The dashboard can emit structured data for main pages; render your own when you need it generated from item data.
- **Client-side tag updates**: Re-resolving and swapping tags during in-app navigation without a full page reload.

For all three, including the per-vertical values, see [Add SEO Support to Item Pages](https://dev.wix.com/docs/go-headless/wix-managed-headless/seo/add-seo-support-to-item-pages.md).

<!-- Need to confirm this works
## SEO for self-managed headless

If you're building a self-managed headless project, Wix doesn't inject any tags or serve `robots.txt` and `sitemap.xml` for you. To configure SEO, you have the following options:

- **Dashboard SEO settings**: Fetch the resolved tags with the [SEO Tags API](https://dev.wix.com/docs/api-reference/site/viewer/seo-tags/introduction.md), the same API the integration calls under the hood, and render them into `<head>` yourself. The dashboard configuration still applies. You just do the rendering the integration would otherwise do for you.
- **Your own code**: Skip the dashboard and hard-code or generate the tags in your frontend.

The automatic, no-code rendering described in this article is what's specific to Wix's Astro integration, not access to the dashboard configuration. -->

## See also

- [Manage SEO for Main Pages](https://dev.wix.com/docs/go-headless/wix-managed-headless/seo/manage-seo-for-main-pages.md)
- [Add SEO Support to Item Pages](https://dev.wix.com/docs/go-headless/wix-managed-headless/seo/add-seo-support-to-item-pages.md)
- [About Wix's Astro Integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/authentication/about-the-astro-integration.md)
- [About the SEO Tags API](https://dev.wix.com/docs/api-reference/site/viewer/seo-tags/introduction.md)