Setting up your first product
A team's first product is made from New product in the web app, where its owner confirms the company name and names the product. Cactus then asks its setup questions one card at a time: your code, your brand, the help you already have, escalations, and Linear.
On this page
Create your first product
Open New product. A team with no product yet sees its form there, headed Your first product.
If a product already exists, select New product in the product menu, which is in the navigation's head. Only an owner sees it there.
On the first product, check the Company name. It starts as the team's saved name, which was made from the owner's email address, and you can change it.
Enter the Product name. The field takes up to 80 characters. On a later product the field is labelled Name.
Select Create product. It stays off until the product name has text, and on the first product until the company name does.
If you changed the company name, Cactus saves it first and then creates the product. When the product is made, Cactus opens the product's help site.
Answer the setup questions
Cactus then asks the setup questions one card at a time, in the order below. Each question comes with a line of Cactus’ own words above its card. It asks the next question you have not answered yet.
Card | What it asks | Where to go next |
|---|---|---|
Your code | What it asks Which repositories the product is built from. Cactus reads them to learn how the product works, and you can change them later in Settings. | Where to go next Once answered, the card folds into a row that names the repositories you picked. |
Your brand | What it asks Your brand, so your help site looks like the rest of your product. | Where to go next Once saved, Cactus says your help site and Messenger wear these colors. See Appearance. |
Help you already have | What it asks Whether you have help pages or docs to bring in, so nothing you wrote is lost. | Where to go next You can enter an old help site's address or connect Intercom. See Imports. |
Escalations to your team | What it asks Where a question that needs a person should go. | Where to go next See Escalations. |
Requests to Linear | What it asks Whether Cactus should file the bugs and requests people mention in your Linear. | Where to go next See Linear. |
On the Linear card, select connect to open Linear's consent screen. Only a workspace admin can pass it. Back from Linear, pick the team that new issues go to and select Done to save it. The card also offers a way to pass without connecting, which costs nothing.
After the last question
When the last card is answered, Cactus says it is reading your code and writing your pages, which it says takes a few minutes. You can follow that work in Builds.
If you can't create a product
What you see | What it means | What to do |
|---|---|---|
“Only a teamspace owner can create a product. Ask one to create it, or to make you an owner under Members.” | What it means Your role on the team is member, and only an owner can create a product. | What to do Ask an owner to create it, or to make you an owner under Members, which you open from the button on that screen. See Team. |
“Couldn’t save this company name. Try again.” | What it means The company name was not saved, so the product was not created. | What to do Select Create product again. |
“Couldn’t create this product. Try again.” | What it means The product was not created. | What to do Select Create product again. |