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.

On this page

Who can open your help site

In Connect › 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

Visitors

Yes, anyone with the address can read it.

Your team

Yes.

Public, with no page listed yet

Visitors

No. Every address answers a visitor as a team-only site does.

Your team

Yes.

Team only

Visitors

No. Visitors see nothing.

Your team

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, 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.

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.

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."

What it means

The name is a bare domain, an address with an IP format, or has a character a domain name cannot hold.

What to do

Enter a subdomain of a domain you own.

"Pick a name under your own domain. Your Cactus address already works."

What it means

The name is under heycactus.ai.

What to do

Use a domain you own, or keep your Cactus address.

"Cactus can’t find that domain in DNS. Check the spelling."

What it means

DNS has no such domain.

What to do

Check the spelling.

"This product already has a domain. Remove that one first."

What it means

This product has a domain connected already, and only one is allowed.

What to do

Remove it first with Hold to remove.

"That domain is connected to another product."

What it means

Another product holds the domain.

What to do

Use a different domain.

"Custom domains aren’t available yet. Try again shortly."

What it means

This deployment has no Cloudflare setup for domains.

What to do

Try again later.

"Cloudflare didn’t answer. Try again in a minute."

What it means

Cloudflare could not be reached.

What to do

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.

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.
  • 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.
  • The contact page has a "Talk to a human" action and a way to ask Cactus. See 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.

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.

text

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

For AI clients that connect to the help, see MCP server.

If readers can't reach the site

What you see

What it means

What to do

"There's no help site here"

What it means

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.

What to do

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.

Website twin check

(none)

Sources

Related pages