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

# Publish a page

> Turn an HTML file into a live, shareable link — from the app or your agent.

A Shareable page is a single, self-contained HTML document — a dashboard, report,
infographic, or mini-site your AI built you. There's no app to run and no database;
Shareable just hosts the HTML and serves it at a link.

<Note>
  Not HTML? You can also share **PDFs and images** — see
  [Share a PDF or image](/cookbook/share-a-pdf-or-image).
</Note>

## Three ways to publish

<Steps>
  <Step title="Drag in a file">
    On [your pages](https://useshareable.com/pages), drop an `.html` file (or paste
    the HTML). Give it a name — you'll get a draft you can preview. Got a **folder**
    with images, CSS, or JS alongside the HTML? Drop the whole folder — it publishes
    as a [multi-page deck](/guides/multi-page-decks) with its assets.
  </Step>

  <Step title="Paste from an AI tool">
    Made it with Claude, ChatGPT, or Gemini? Copy the HTML and paste it in. When pasting,
    keep everything **self-contained** — CSS, fonts, and images inlined (separate files
    can't come along with a paste; upload a folder for that).
  </Step>

  <Step title="Publish straight from your AI app">
    With your AI app [connected](/guides/publish-from-ai), just ask: *"publish this and give
    me a shareable link."* Claude, ChatGPT, or Gemini publishes and hands back the URL — no
    copy-paste.
  </Step>
</Steps>

## Draft → published → update

Every page has a **draft** (your working copy) and a **published** version (what
visitors see). Editing changes the draft only; the live link keeps showing the last
published version until you hit **Publish update**. So you can iterate freely
without disrupting anyone who already has the link.

<Note>
  Open a page to preview it, replace its HTML, see analytics, browse version
  history, and manage who can see it — all from the page's header.
</Note>

## Get the link out

Once published, copy the link from the page or the **Share** dialog and send it
anywhere. Who can open it depends on the [access mode](/guides/sharing-and-access)
you choose.

## Custom link previews (unfurls)

When your link is pasted into iMessage, Slack, or social apps, the preview card
is yours to control — two ways:

**From the Share dialog** (no HTML editing): open the page's **Share → Publish**
tab and use **Link preview** to set the card's title, description, and image —
upload an image or pick one of your deck's own assets. Settings here win over
anything in the HTML.

**From your HTML**: define Open Graph tags and Shareable keeps them:

```html theme={null}
<meta property="og:title" content="Your Week, Mapped">
<meta property="og:description" content="A 3-minute self-assessment.">
<meta property="og:image" content="https://example.com/card.png">
```

* In a [multi-page deck](/guides/multi-page-decks), `og:image` can point at a
  **bundled asset** with a relative path (`images/logo.png`) — no external
  hosting needed.
* Tags you don't define fall back gracefully: the preview title comes from your
  HTML's `<title>` (then the page's display name), on Shareable's generated
  card background.
* Custom previews show for **public link** pages. Password and invite-only
  pages deliberately don't reveal their content to link crawlers, so they
  show a generic preview.

<Note>
  Made the page with AI? Just ask: *"add Open Graph meta tags with a title,
  description, and og:image pointing at the logo"* — then republish.
</Note>

<Card title="Next: choose who can see it" icon="lock" href="/guides/sharing-and-access">
  Private, link, password, specific people, or verified-email access.
</Card>