---
lang: en
---

# Help site

The help site is the public address where readers browse a product's help pages, what's new, and ask questions, at a Cactus address (`<name>.heycactus.ai`) or the team's own domain, and a team can limit it to the team only. Visitors can open it only once the team chooses Public and at least one page is listed, while the team can always read it.

> Verified against the product on 2026-11-20

## Who can open your help site

In [Connect › Help site](https://app.heycactus.ai/deploy/help-site), the **Who can open it** panel holds two choices, **Public** and **Team only**.

| Setting | Visitors | Your team |
| --- | --- | --- |
| **Public**, with at least one page listed | Yes, anyone with the address can read it. | Yes. |
| **Public**, with no page listed yet | No. Every address answers a visitor as a team-only site does. | Yes. |
| **Team only** | No. Visitors see nothing. | Yes, when they are signed in to the product. |

A visitor who opens a site that is not open to them sees the title "There's no help site here".

Any member of the product's team can change this switch, not only an owner.

## Your address

The address is `https://<name>.heycactus.ai`, where the name is the one in the **Name** field of the **Address** panel.

- A name is 3 to 40 characters long.
- A name uses lowercase letters, numbers and single hyphens.
- A name cannot be a reserved word such as `api`, `docs` or `login`.

Saving a name that another product already holds shows "That name is taken. Try another." Any member of the team can save a new name.

Saving a new name changes the address at once, and the old address stops finding the site.

### Visit a team-only site

On a team-only site, **Visit site** opens the site through the app, not its address.

The link carrying the pass lasts 5 minutes.

## Use your own domain

Only an owner can connect, check or remove a custom domain.

### Connect a domain

1. In [Connect › Help site](https://app.heycactus.ai/deploy/help-site), enter your domain under **Your own domain** and select **Connect**. Use a subdomain such as `help.yourcompany.com`.
2. Add the record the panel shows where you manage DNS: **Type** `CNAME`, **Name** the domain without its zone, and **Target** `customers.heycactus.ai`.
3. Wait for the panel to read **Live**.

> **Note:** If you use Cloudflare for DNS, set the record to DNS only.

Once the domain is **Live**, it is the site's one address, and the panel says the Cactus address and every older link send visitors there.

### Domain states

The panel shows one of four words for a connected domain, or nothing when none is connected.

- **Waiting for DNS**: the hostname does not yet answer as active at Cloudflare.
- **Issuing certificate**: the hostname is active and the certificate is not yet.
- **Live**: the hostname and the certificate are both active.
- **Needs attention**: Cloudflare reports a stuck status, or an error has stood for more than 10 minutes since the domain was connected.

*The states a connected custom domain moves through, as the panel names them.*

Waiting for DNS · Issuing certificate · Live · Needs attention

- Waiting for DNS › hostname active › Issuing certificate
- Issuing certificate › hostname and certificate active › Live
- Waiting for DNS › stuck status or old error › Needs attention
- Issuing certificate › stuck status or old error › Needs attention
- Live › a later check finds a stuck status › Needs attention

```mermaid
stateDiagram-v2
state "Waiting for DNS" as Waiting
state "Issuing certificate" as Issuing
state "Live" as Live
state "Needs attention" as Attention
[*] --> Waiting
Waiting --> Issuing: hostname active
Issuing --> Live: hostname and certificate active
Waiting --> Attention: stuck status or old error
Issuing --> Attention: stuck status or old error
Live --> Attention: a later check finds a stuck status
```

When the domain needs attention, the panel shows Cloudflare's own sentence and one line of what to do, and **Check again** asks Cloudflare once more.

### If a domain won't connect

| What you see | What it means | What to do |
| --- | --- | --- |
| "Use a subdomain such as help.yourcompany.com." | The name is a bare domain, an address with an IP format, or has a character a domain name cannot hold. | Enter a subdomain of a domain you own. |
| "Pick a name under your own domain. Your Cactus address already works." | The name is under heycactus.ai. | Use a domain you own, or keep your Cactus address. |
| "Cactus can’t find that domain in DNS. Check the spelling." | DNS has no such domain. | Check the spelling. |
| "This product already has a domain. Remove that one first." | This product has a domain connected already, and only one is allowed. | Remove it first with **Hold to remove**. |
| "That domain is connected to another product." | Another product holds the domain. | Use a different domain. |
| "Custom domains aren’t available yet. Try again shortly." | This deployment has no Cloudflare setup for domains. | Try again later. |
| "Cloudflare didn’t answer. Try again in a minute." | Cloudflare could not be reached. | Try again in a minute. |

### Remove a domain

Select **Hold to remove** and keep it held. The panel says where visitors go once the domain is removed.

A removed domain stops answering.

If DNS moves away, the domain stops being live without anyone opening the panel.

## Privacy and terms links

In the **Privacy and terms** panel, paste the address of your privacy policy and of your terms.

An address must start with `https://`, and an empty field shows no link.

Both links show in the footer of every page of the site. Any member of the team can save them.

## What readers find on the site

- The home page lists the help pages by topic, and up to eight pages you pick show first as featured pages. Pick them on [featured pages](https://cactus.heycactus.ai/2p37ct-featured-pages).
- Each help page has its own address, and an old address for a page moves to its new one.
- What's new is at the site's `/whats-new` address, with each change on its own. See [What's new](https://cactus.heycactus.ai/8xe7nn-what-s-new).
- The contact page has a "Talk to a human" action and a way to ask Cactus. See [Handoffs](https://cactus.heycactus.ai/a5tamg-handoffs).
- A site can add `fr`, `ja` and `ar` as languages, each at its own address. A language the site does not have live shows the English page. Set them on [Translation](https://cactus.heycactus.ai/pkg3jf-translation).

## How AI reads your help site

The **Read by AI** panel at the top of the screen shows how often AI read the site over the last seven days, by day and by page.

Until an AI reads the site, the panel says "No AI has read your help site yet. I’ll tell you here when one does."

A public site also shows a command that copies every public page into a folder an AI agent can read.

```
git clone https://<your site address>/memory.git
```

For AI clients that connect to the help, see [MCP server](https://cactus.heycactus.ai/taww5u-mcp-server).

## If readers can't reach the site

| What you see | What it means | What to do |
| --- | --- | --- |
| "There's no help site here" | The address names no site, the site is team only and you are not signed in to its team, or it is public with no page listed yet. | Set **Who can open it** to **Public** once a page is listed, or sign in as a member of the team. A page is listed after a [build](https://cactus.heycactus.ai/7q7w26-builds). |

> **Warning:** Changing the name in **Address** takes the old address off at once. Share the new address before you save.

## Website twin check

(none)
