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

  1. In SettingsGeneral, enter the product’s name in Name.

  2. 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 SettingsAppearance.

Change the logo

  1. In SettingsAppearance, 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.

  1. In SettingsAppearance, under Brand, select a swatch under Brand color, or type a colour under Any color.

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

  1. Under Brand, in the Messenger row, select Pick its own colors.

  2. 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, SettingsRules, lists the writing rules: settled decisions about how pages are written and how the product is laid out.

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

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

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

  1. 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 SettingsGeneral holds two actions, and both are for a team owner only.

Both buttons show to every member.

Rebuild from scratch

A rebuild needs at least one linked repository, because the build reads from it.

  1. Select Rebuild from scratch.

  2. In the dialog, type the product’s name in the box.

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

  1. Select Delete this product.

  2. In the dialog, type the product’s name in the box.

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

Sources

Related pages