Settings
Settings holds a product’s own options on three tabs: its name on General, its logo, brand color, type, Messenger colors and help site layout on Appearance, and its writing rules on Rules. Any team member can change most of them, but only a team owner can rebuild or delete the product.
On this page
Change the product name
In Settings
General, enter the product’s name in Name. Select Save.
The app shows this name for the product everywhere. Any team member can save it.
Change the logo, colors and type
Most of these save as soon as you pick them. A colour you type under the brand color and the Messenger’s own colors wait for Save.
All of them are on Settings
Change the logo
In Settings
Appearance, select the Light theme or Dark theme tile, then choose a file.
A file can also be dropped on the tile.
A logo must be a PNG, JPEG or WebP file up to 512 KB, and an animated GIF is refused.
Without an upload, Cactus uses the logo from your website, and the tile reads Found automatically. Remove takes away an uploaded logo and puts that theme back on the logo found automatically.
Change the brand color
The app, your help site and the Messenger all wear the brand color, one for light mode and one for dark. Cactus reads it from your site, or you can pick it.
In Settings
Appearance, under Brand, select a swatch under Brand color, or type a colour under Any color. If you typed a colour, select Save.
Cactus’ green sets the brand color back to Cactus’ own green. Any team member can save the accent.
The brand panel shows Brand confirmed once a brand is read or confirmed, and No brand yet until then. Beside it, it shows Read from and the site’s address when the product has one.
An owner can have Cactus read the brand again with Read your brand. It opens setup on Home, and nothing changes until you answer there. The button shows only when the product has a website address and you are an owner.
Change the type
Under Type, choose Sans or Serif. Your docs use this type in the app and on your help site.
Both options stay off until the brand has a type, and then they read No brand type yet.
Change the Messenger’s colors
Until you pick colors of its own, the Messenger wears the brand color, and its row reads Same accent as the app and your help site.
Under Brand, in the Messenger row, select Pick its own colors.
Set Primary, light, Primary, dark, Secondary, light and Secondary, dark, then select Save.
To go back to the accent, select Use the accent. These colors are an override set here and nowhere else, as the Messenger wears them.
Change how the on-screen helper moves
Under Motion, choose Drop or Blink for Long moves. The choice sets how the on-screen helper moves a long way across a page.
Change the help site layout
The Help site panel sets how the help site lays out its home page and its changelog, one option at a time.
Setting | Option | What it shows |
|---|---|---|
Help site layout | Option Spotlight | What it shows The main pages as cards, the topics in one line. |
Help site layout | Option Catalog | What it shows The main pages as cards, every topic with its pages. |
Changelog layout | Option Logbook | What it shows Weeks down a rail, each week’s changes as cards. |
Changelog layout | Option Chapters | What it shows Each week a picture and a row of short chapters. |
Changelog layout | Option Covers | What it shows Each week led by a cover drawn from what it shipped. |
The changelog layout sets how What’s new entries are drawn. Agents page adds a page to your help site that shows how to connect an AI agent. Which pages show first on the home page is set in Featured pages.
Writing rules
The Rules tab, Settings
Rules are grouped by what honours them: the map, the page layout, page writing, answers and the changelog. Each rule shows its text and its quote, and who set it and when. A rule Cactus learned reads Learned.
Change who a rule is for
On the rule, select Both, Customer or Internal.
Any team member can change a rule’s audience.
Retire a rule
Anyone can retire a rule they set. Only a team owner can retire a rule someone else set.
On the rule, select Retire.
For 4 seconds the button reads Undo. Escape, or a second press while the button or its row has focus, takes the retire back.
When the window ends, the rule is retired and the pages it shaped are written again.
See the pages a rule reaches
A rule that shapes page writing shows Pages this reaches, which lists the pages it has reached. Each rule also states how many pages are done and how many sections cite it.
A rule only the map or the page layout honours has no page list.
Learn rules from your writing
Select Learn from your writing.
Cactus reads your writing and writes what it finds as rules below. A learn can take minutes.
If the learn is still running after 3 minutes, the page says Cactus is still reading and the rules will appear when it is done.
Build pages from the rules
Under Build, Generate now starts a new build. Published pages stay as they are until it is done.
Generate now is off while a build runs or is paused. Cancel build stops the running build, and it is off when none runs. Each build is listed on Builds.
Rebuild or delete the product
The Danger zone at the foot of Settings
Both buttons show to every member.
Rebuild from scratch
A rebuild needs at least one linked repository, because the build reads from it.
Select Rebuild from scratch.
In the dialog, type the product’s name in the box.
Select Rebuild from scratch in the dialog. It is off until the name matches.
Cactus cancels any running build, starts the rebuild, and opens Builds.
The product learns again from its repositories and rewrites its docs. Docs stay up until each is rewritten, and conversations, settings and imports are kept.
Delete the product
Select Delete this product.
In the dialog, type the product’s name in the box.
Select Delete for good. It is off until the name matches.
This removes the product, its docs and its conversations, and it can’t be undone.
Before it removes them, Cactus clears the product’s open conversations and removes any custom domain.
Then Cactus opens the team’s next product, or the page for a new product if none is left.
If something doesn’t work
What you see | What it means | What to do |
|---|---|---|
“Couldn’t save this product. Try again.” | What it means The name did not save. | What to do Select Save again. |
“Couldn’t find this product.” | What it means The action is for an owner, and you are not one. | What to do Ask a team owner to do it. |
“That file is over 512 KB. Pick a smaller one.” | What it means The logo file is too large to upload. | What to do Pick a PNG, JPEG or WebP file up to 512 KB. |
“Use a PNG, JPEG, or WebP file.” | What it means The file is an animated GIF or another type. | What to do Pick a PNG, JPEG or WebP file. |
“Couldn’t upload that logo. Try again.” | What it means The logo upload failed. | What to do Try again. |
“Couldn’t save the accent. Try again.” | What it means The brand color did not save, and the page goes back to the saved one. | What to do Try again. |
“Couldn’t save the Messenger’s colors. Try again.” | What it means The Messenger’s own colors did not save. | What to do Try again. |
“Cactus couldn’t read your brand. Try again.” | What it means The brand read failed. | What to do Try again. |
“Your team has no website for Cactus to read.” | What it means Read your brand needs a website for the team. | What to do Pick the brand color by hand. |
“Only a teamspace owner can retire a rule someone else set.” | What it means The rule was set by someone else. | What to do Ask a team owner to retire it. |
“Cactus is still reading your writing. The rules will appear here when it’s done.” | What it means The learn ran past 3 minutes. | What to do Wait, then check the rules list. |
“Link a repository before rebuilding: the build reads from it.” | What it means No repository is linked to the product. | What to do Link a repository, then rebuild. |
“That name doesn’t match. Type the product name to confirm.” | What it means The name typed in the dialog is not the product’s name. | What to do Type the name exactly as the product has it. |
“Cactus couldn’t confirm the build started. Press again: it won’t start a second one.” | What it means The rebuild’s start was not confirmed. | What to do Press Rebuild from scratch again. |