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,docsorlogin.
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
In Connect › Help site, enter your domain under Your own domain and select Connect. Use a subdomain such as
help..yourcompany. com Add the record the panel shows where you manage DNS: Type
CNAME, Name the domain without its zone, and Targetcustomers..heycactus. ai 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.
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 statusWhen 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. | 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.
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.
- 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-newaddress, 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,jaandaras 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.
git clone https://<your site address>/memory.gitFor 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)