About SEO Support

Wix-managed headless projects built with the Astro integration 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:

  • 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.

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.

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, such as Wix Stores products, Wix Bookings services, Wix Events, and Wix Blog posts, plus their category pages. You register each route and render its tags in code using the @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.

See also

Last updated: 1 July 2026

Did this help?