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

# Sharing your site

> What the link card shows when someone shares your site, where its title, description and image come from, and how to change them.

Paste your site's address into Slack, iMessage, LinkedIn or X, and the person
you sent it to sees a small preview before they click — a title, a line of
description and an image. That preview is the **link card**, and this page
covers what's in it and how to change it.

<Note>
  This page describes the Goosy settings behind the link card. For the raw
  tags a scraper reads (`og:image`, `og:title`, `twitter:card`, and how the
  platform fills `robots.txt`, `sitemap.xml` and `llms.txt`), see [Pages
  API](/api/pages) and [Managed capabilities for Pages](/api/pages-capabilities).
</Note>

## What the link card shows

Three things, and nothing else: a **title**, a short **description**, and an
**image**. On X, you choose between the wide picture card, which fills the
whole width with the image, and the small square one beside the text.

## Where its values come from

Each of the three is resolved in the same order, checked top to bottom until
one of them has something to say:

1. **Set in Goosy.** Once a value is set for a field, it wins over everything
   below, on every page it applies to — see [Changing
   them](#changing-them) below.
2. **From the page.** If you brought in a project that already declares its
   own title, description or image, that's what shows until a Goosy setting
   overrides it.
3. **Read from your site.** When your site was imported or built, Goosy read
   whatever it could find and kept it as a starting point for any field the
   page itself didn't declare.
4. **By platform default.** With nothing above to go on, the card falls back
   to your page's own title and a picture Goosy composes for that page — a
   screenshot of the page with its title and your brand mark, never an
   invented title or description.

Nothing is ever invented for a page that has genuinely nothing to show: a page
with no title anywhere simply has no title in its link card, same as it would
without any of this.

## Changing them

**Title, description and layout:** ask Goosy in plain words — "change the
share title to …", "make the description say …", "use the wide picture
card" — and the setting changes directly; the live card follows on its next
fetch.

**The image** is a picture edit, not a setting you type: open **Site
settings** and pick the picture slot for your site's social image, the same
way you'd pick any other image slot on the site. Ask Goosy for what you want
there, and it takes it from there.

## Your site's files are never touched

None of this rewrites your site's own code. A value you set through Goosy is
stored as a Goosy setting alongside your site, never inside it — so it
survives a rebuild, without your page's own title, description or image tag
ever being edited to hold it.

## Where to go next

* [Pages API](/api/pages) — the full call reference for importing, building
  and publishing a site.
* [Bringing your own site](/api/bringing-your-own-site) — what an imported
  project's own tags can declare.
* [Managed capabilities for Pages](/api/pages-capabilities) — the AI and
  retrieval operations available on a hosted site.
