> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoppex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SEO, link previews, and favicon

> Set the title, description, and image that Google, Discord, and X show for your shop, plus the icon in the browser tab.

Everything a search engine or a chat app reads about your shop is set in two places in the
dashboard. Neither one needs a theme publish: changes go live on your storefront as soon as you
save.

| What you want to change                                                             | Where                                              |
| ----------------------------------------------------------------------------------- | -------------------------------------------------- |
| Title in the browser tab and in Google results                                      | **Settings → Shop → SEO** → Meta Title             |
| Text under the title in Google and in link previews                                 | **Settings → Shop → SEO** → Meta Description       |
| Image shown when someone shares your shop link on Discord, X, Telegram, or iMessage | **Settings → Shop → SEO** → Share Image            |
| A different title or image for one page, for example every product page             | **Settings → Shop → SEO** → Page Overrides         |
| Icon in the browser tab, bookmarks, and search results                              | **Settings → Shop → Branding** → Favicon           |
| Prices and ratings inside Google results                                            | **Settings → Shop → SEO** → Rich Results on Google |

This applies to both Easy themes and Advanced code storefronts. The Theme Builder does not have
its own SEO fields.

## What shows when a field is empty

Shoppex never leaves a tag blank. When you have not set a value, it falls back in this order:

* **Meta Title**: your shop name.
* **Meta Description**: your shop description from **Settings → Shop → General**, or a generic
  line like "Shop at Your Shop - Premium digital products" if that is empty too.
* **Share Image**: your shop logo. If there is no logo either, a generated card with your shop name.
* **Favicon**: your shop logo, then the Shoppex default icon.

If a link preview of your shop looks generic, one of these fields is empty. Fill it in and share
the link again.

## Share image size

Use a 1200 × 630 pixel PNG or JPEG. Discord, X, and most messengers crop to that ratio, so a square
logo ends up with cut-off edges. Keep any text inside the middle 80% of the image.

## Page overrides

A page override gives one route its own title, description, or share image. The route is the path
after your domain:

* `/` is the home page.
* `/product/:slug` matches every product page. `:slug` stands for any product.
* `/page/:slug` matches every custom page.
* `/product/premium-key` matches one product only.

An empty field in an override falls back to the shop-wide value above it.

## Previews still show the old image

Discord, X, Telegram, and iMessage cache link previews for hours, sometimes days, and a message
that was already sent keeps the preview it had. To check the current state, paste the link in a
fresh message, or use the [Discord embed debugger](https://discord.com/developers/embeds) or the
[X Card Validator](https://cards-dev.twitter.com/validator).

Browsers cache favicons even longer. If the old icon still shows after you saved a new one, open
your shop in a private window.

## Related

* [Custom domain](/storefront/custom-domain): the share image and canonical URL use the domain
  your shop is served from, so connect the custom domain first if you plan to use one.
* [Troubleshooting](/storefront/troubleshooting) for a storefront that does not load at all.
