---
lang: en
---

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

> Verified against the product on 2026-11-20

## Change the product name

1. In **Settings › General**, enter the product’s name in **Name**.
2. Select **Save**.

> **Note:** The name can be up to 80 characters, and **Save** stays off while the name is blank.

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 › Appearance**.

### Change the logo

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

1. In **Settings › Appearance**, under **Brand**, select a swatch under **Brand color**, or type a colour under **Any color**.
2. If you typed a colour, select **Save**.

> **Note:** A swatch saves as soon as you select it.

**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](https://cactus.heycactus.ai/w6vu4g-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](https://cactus.heycactus.ai/97jtg9-on-screen-helper) moves a long way across a page.

### Change the help site layout

The **Help site** panel sets how the [help site](https://cactus.heycactus.ai/94dn3s-help-site) lays out its home page and its changelog, one option at a time.

| Setting | Option | What it shows |
| --- | --- | --- |
| Help site layout | **Spotlight** | The main pages as cards, the topics in one line. |
| Help site layout | **Catalog** | The main pages as cards, every topic with its pages. |
| Changelog layout | **Logbook** | Weeks down a rail, each week’s changes as cards. |
| Changelog layout | **Chapters** | Each week a picture and a row of short chapters. |
| Changelog layout | **Covers** | Each week led by a cover drawn from what it shipped. |

The changelog layout sets how [What’s new](https://cactus.heycactus.ai/8xe7nn-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](https://cactus.heycactus.ai/2p37ct-featured-pages).

## Writing rules

The **Rules** tab, **Settings › Rules**, 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**.

> **Note:** A change is saved at once, and the pages it changes are written again.

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](https://cactus.heycactus.ai/7q7w26-builds).

## Rebuild or delete the product

The **Danger zone** at the foot of **Settings › General** 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](https://cactus.heycactus.ai/7q7w26-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.” | The name did not save. | Select **Save** again. |
| “Couldn’t find this product.” | The action is for an owner, and you are not one. | Ask a team owner to do it. |
| “That file is over 512 KB. Pick a smaller one.” | The logo file is too large to upload. | Pick a PNG, JPEG or WebP file up to 512 KB. |
| “Use a PNG, JPEG, or WebP file.” | The file is an animated GIF or another type. | Pick a PNG, JPEG or WebP file. |
| “Couldn’t upload that logo. Try again.” | The logo upload failed. | Try again. |
| “Couldn’t save the accent. Try again.” | The brand color did not save, and the page goes back to the saved one. | Try again. |
| “Couldn’t save the Messenger’s colors. Try again.” | The Messenger’s own colors did not save. | Try again. |
| “Cactus couldn’t read your brand. Try again.” | The brand read failed. | Try again. |
| “Your team has no website for Cactus to read.” | **Read your brand** needs a website for the team. | Pick the brand color by hand. |
| “Only a teamspace owner can retire a rule someone else set.” | The rule was set by someone else. | Ask a team owner to retire it. |
| “Cactus is still reading your writing. The rules will appear here when it’s done.” | The learn ran past 3 minutes. | Wait, then check the rules list. |
| “Link a repository before rebuilding: the build reads from it.” | No repository is linked to the product. | Link a repository, then rebuild. |
| “That name doesn’t match. Type the product name to confirm.” | The name typed in the dialog is not the product’s name. | 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.” | The rebuild’s start was not confirmed. | Press **Rebuild from scratch** again. |
