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

# Editor and publishing

> Edit your Showcase and publish changes live.

The **Showcase** is your company's website. Open it from the sidebar and you land in a visual editor: your live site fills the canvas, drawers slide in for pages, blocks, design, and settings, and an assist bar turns plain-English requests into edits you review before they stick.

Everything you change lands in a **draft**. The draft autosaves as you work. Nothing goes live until you click **Publish**.

## The canvas

The center of the editor is a live preview of your site. Switch between desktop, tablet, and mobile at the top to see how each page looks at each width.

Click any text on the canvas to edit it inline — headings, body copy, button labels. A popover opens with the current value and the default it falls back to. Click an image to swap it.

## Drawers

Four drawers slide in from the right edge:

* **Pages** — add, reorder, hide, and navigate between pages. Each page has its own slug and SEO fields.
* **Blocks** — add or rearrange sections on the current page (hero, gallery, services, testimonials, etc.). Available only on section-composed pages.
* **Design** — change the template, adjust theme colors, and swap the overall look without rebuilding content.
* **Settings** — site-level SEO defaults, contact display toggles, and domain configuration.

## The assist bar

Type a request in plain English — *"add a gallery page with my pool construction work"* or *"change the hero heading to mention saltwater pools"* — and the agent parses it into typed edits. Nothing is applied silently: each proposed change appears as a card you accept or reject. Accepted edits land in the draft and autosave like any manual edit.

<Steps>
  <Step title="Type your request">
    Open the assist bar at the top of the editor and type what you want changed. Keep it to one idea per message.
  </Step>

  <Step title="Review the proposal">
    The agent returns one or more proposed edits. Each card shows what will change. Click **Accept** to stage it in the draft, or **Reject** to discard it.
  </Step>

  <Step title="Check the canvas">
    Accepted edits appear immediately in the preview. If something looks off, press **Cmd+Z** (Mac) or **Ctrl+Z** (Windows) to undo — every proposal is a single undo entry.
  </Step>
</Steps>

**Success:** the canvas reflects the change and the **Publish** button shows an unpublished-changes indicator.

## AI site generation

For a full refresh or a from-scratch start, the **Generate** button (top bar) runs the AI site generator. Choose to regenerate the entire site or just the current page. The generator streams progress in real time — pages, copy, and images — and commits the result as one draft you can review before publishing.

<Accordion title="Generation replaced a page I wanted to keep">
  Generation is a single undo entry. Press **Cmd+Z** immediately after the result lands to restore the previous pages. If you've already made other edits since, open **Pages** and restore from a prior version in the version history.
</Accordion>

## Publishing

<Steps>
  <Step title="Review your changes">
    The top bar shows how many pages have unpublished changes. Click through pages to confirm everything looks right in desktop and mobile preview.
  </Step>

  <Step title="Click Publish">
    The **Publish** button is in the top bar. It promotes your draft to the live site, creates an immutable version snapshot, and busts the public-site cache so visitors see the new version on their next visit.
  </Step>
</Steps>

**Success:** the button returns to its resting state (no unpublished changes), and the version number increments by one. Your site is live.

<Accordion title="Publish failed with a webchat error">
  If a web chat widget on the site references a configuration that's been deleted, publishing is blocked — the widget would break on the live site. Open **Settings**, remove or fix the widget reference, then publish again.
</Accordion>

## Version history

Every publish creates a snapshot. Open the version list to see when each version was published and by whom.

<Steps>
  <Step title="Open version history">
    In the **Settings** drawer, find the version history section. The list shows the most recent publishes, newest first.
  </Step>

  <Step title="Restore a version">
    Click **Restore** on any snapshot. The snapshot is copied into your draft — it does **not** go live automatically. Review the restored draft and click **Publish** when you're ready.
  </Step>
</Steps>

**Success:** the draft now shows the restored content and the **Publish** button is active. The live site is unchanged until you publish.

<Accordion title="Restored the wrong version">
  Restore only writes to the draft, so the live site is safe. Press **Cmd+Z** to undo the restore, or restore a different version — each restore replaces the current draft.
</Accordion>

## Custom domain

Your site starts on a Kordless subdomain (`yourcompany.kordless.ai`). To use your own domain (`yourcompany.com`), connect it from the **Settings** drawer.

<Steps>
  <Step title="Search or buy a domain">
    In **Settings**, search for a domain. If it's available, you can buy it through Kordless (registration, DNS, and SSL are all managed for you) or connect a domain you already own.
  </Step>

  <Step title="Point your DNS (connect-only)">
    If you're connecting a domain you own elsewhere, add the DNS records Kordless shows you at your registrar. The status updates from *pending DNS* to *active* once propagation completes — usually within minutes, sometimes up to 48 hours.
  </Step>
</Steps>

**Success:** the domain shows **Active** and your site is served from the custom domain. The Kordless subdomain continues to redirect.

<Accordion title="Domain is stuck on pending DNS">
  DNS propagation can take up to 48 hours, though most resolve within minutes. Verify the records match exactly — a missing trailing dot or wrong value is the most common cause. If records are correct and 48 hours have passed, [contact support](https://kordless.ai/form/contact).
</Accordion>

<Accordion title="I bought a domain but the registration failed">
  Failed registrations are retried automatically up to three times. If all attempts fail, the order is marked as failed and you're not charged for the domain. The payment is refunded. Contact support to retry manually or choose a different name.
</Accordion>

## Next steps

<CardGroup cols={2}>
  <Card title="Blog posts" icon="pen-square" href="/pool-spa/website/blog">
    Draft, refine, and publish posts with the agent.
  </Card>

  <Card title="Reviews showcase" icon="star" href="/pool-spa/website/reviews">
    Put your best Google reviews on your site and keep them there.
  </Card>
</CardGroup>