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

# Publish as Site

> Publish a Parable at its own web address, such as tripleseat.today/engineering-delivery, behind your Workspace's login.

# Publish as Site

## Sources

Docs: [Publishing](https://docs.parable.work/ponder/parables/permissions/publishing.md), [Primary](https://docs.parable.work/ponder/parables/permissions/primary.md), [Login & Authorization](https://docs.parable.work/protection/login.md)

Web App: in a Parable, open **Participants**. The **Publish as Site** card is at
the foot of the Participants panel.

**Publish as Site** gives a Parable its own web address, such as
`tripleseat.today/engineering-delivery`. A person who opens the address logs in
through your Workspace's login and then sees the Parable alone: its Page, edge
to edge, with no sidebar, no header, no title, no description and no Ponder.
Parable calls this view **Shared Mode**.

A site is a web address that holds a Workspace's Parables. Each Parable on a
site has a **handle**, the part after the slash.

## Publish a Parable

1. Open **Participants** and open the **Publish as Site** card.
2. In **Site**, pick a site. Every Workspace has a free site,
   `<your Workspace>.parable.space`. Type a name to find a domain to buy.
3. In **Handle**, keep the handle from the Parable's name or type another.
4. Press **Publish**.

You need the [Publishing](https://docs.parable.work/ponder/parables/permissions/publishing.md) or
[Primary](https://docs.parable.work/ponder/parables/permissions/primary.md) seat on the Parable. A reader
with another seat sees the address on the card but cannot change it.

## Sites

### The free site

Every Workspace can use `<your Workspace>.parable.space` at no cost. Picking it
the first time sets it up. A Workspace whose name Parable keeps for itself
under `parable.space`, such as `premises`, has no free site.

### Buy a domain

Type a name, such as `tripleseat`, in **Site**. The list shows domains that you
can buy now, each with its yearly price. These extensions come first, when they
are available: `.today`, `.space`, `.site`, `.team`, `.directory`, `.xyz` and
`.fyi`. A domain that is not available does not show, and neither does one
that costs more than \$100 a year, for its first year or a renewal.

* Only a Workspace Administrator can buy a domain.
* Pick a domain, check its price, and press **Buy**. Parable buys the domain
  for your Workspace through Cloudflare. A purchase cannot be refunded.
* The price is Cloudflare's price at the moment of purchase. If it changed since
  the search, the card shows the new price and asks you to confirm again.
* The domain renews each year.

### The cap

A Workspace can buy one domain. At the cap, the list offers **Request from
Parable Pros**. The request goes to the Parable team, which can raise your cap.
A purchase that failed does not count against the cap.

### Provisioning

A new site shows **Provisioning** until its address works. The card shows each
step as it happens:

1. **Buying the domain**
2. **Waiting for the registry**
3. **Setting up the zone**
4. **Pointing the address**

The free site starts at **Setting up the zone**. A site is usually **Live**
within a minute. You can publish a Parable on a site while it provisions. Its
address works once the site is live.

A site that fails shows why, such as **This domain is no longer available.
Nothing was charged.** Pick another site. A failed purchase charged nothing.

Once Parable has bought a domain, its site does not fail. If a step cannot
finish, such as when the registry holds the purchase for review, the card keeps
showing that step, and the Parable team finishes it.

## Handles

* A handle uses lower-case letters, digits and hyphens, such as
  `engineering-delivery`.
* Two Parables in one Workspace cannot have the same handle, on any site.
* A handle is not the Parable's own handle. Changing one does not change the
  other.
* Parable keeps some handles for its own pages, such as `login` and `ponder`.
  The card says so when you type one.

## Login

**Require login** is always on. Every reader logs in through your Workspace's
login, as they do in the app: SSO, Google or email, by your Workspace's
settings. **Let people log in with a work account** opens
[Login & Authorization](https://docs.parable.work/protection/login.md), where a Workspace Administrator
sets up SSO.

A reader who already has a Parable session passes through without a click.
Only a person who can open the Parable in the app can read it on the site: a
member of your Workspace, or a Parable Pro with
[Pros Access](https://docs.parable.work/protection/pros-access.md) to it. Anyone else sees "You can't open
this site." The Parable's seats and Policies decide what each reader sees, as
in the app.

## Change or remove the address

Open the card and press **Edit** to pick another site or handle. The old
address stops working at once. **Unpublish** removes the address. The site
stays with your Workspace, and you can publish another Parable on it.

## What a site does not do yet

* A site always requires login. Public sites are not available.
* A Parable has one address.
* A site serves the Parable from Parable itself. It keeps no copy and uses no
  cache.
* A Workspace cannot release a domain it bought, or bring a domain it bought
  elsewhere.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.