Product settings

Product settings hold the product's name, which any team member can change in Settings › General, and the danger zone, where a teamspace owner can rebuild the product from scratch or delete it for good.

On this page

Rename a product

  1. In Settings › General, change the text in Name under Product.

  2. Select Save. It stays off while the name is empty.

The name can be up to 80 characters. The app uses it for the product everywhere. Saving changes only the name. Any member of the team can save a new name.

If the save fails, the screen shows "Couldn’t save this product. Try again." under Name.

Rebuild a product from scratch

Only a teamspace owner can rebuild a product.

  1. In Settings › General, scroll to Danger zone and select Rebuild from scratch.

  2. Type the product's name in the box. Rebuild from scratch stays off until the name matches exactly.

  3. Select Rebuild from scratch in the dialog.

After the rebuild starts, the screen moves to Settings › Builds.

The product needs at least one connected repository before it can be rebuilt, because the build reads from it. Without one, the rebuild stops with "Link a repository before rebuilding: the build reads from it."

A rebuild first cancels a build that is running, then starts a new one that writes from scratch.

The rebuild does not drop the code index or the search: they stay live while the new build refreshes them.

Your current docs stay up until each one is rewritten.

Delete a product

Only a teamspace owner can delete a product.

  1. In Settings › General, scroll to Danger zone and select Delete this product.

  2. Type the product's name in the box. Delete for good stays off until the name matches exactly.

  3. Select Delete for good.

Deleting clears open conversations and removes any custom domain. Then the product and its data are deleted, and connections used only by this product are removed too.

When the delete finishes, the screen opens the docs of the team's next product. If the team has no other product, it opens the new-product screen.

If a rebuild or delete stops

What you see

What it means

What to do

"Cactus couldn’t confirm the build started. Press again: it won’t start a second one."

What it means

The request may or may not have reached the build.

What to do

Select the same button again. Pressing again sends the same request and cannot start a second build.

"Couldn’t start the rebuild. Try again."

What it means

Cactus refused the rebuild.

What to do

Try again.

"Link a repository before rebuilding: the build reads from it."

What it means

The product has no connected repository.

What to do

Connect a repository in Sources, then rebuild.

"Cactus cleared the parts it removed, but couldn’t remove the part that failed. The product is still here: try again to finish deleting it."

What it means

A step of the delete failed before the product was removed.

What to do

Type the name and select Delete for good again.

"Couldn’t delete this product. Try again."

What it means

The delete did not finish.

What to do

Try again.

Connect a repository in Sources before rebuilding.

Related pages