> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guided setup

> How a new workspace gets built: tell Stella about your business, review the setup it drafts, then build it while you connect your inbox and invite your team.

## Overview

Every new workspace starts with the **guided setup**. You answer a few questions
about your business, Stella, your AI teammate, drafts a setup to match (objects,
pages, teams and a customer journey), and you review it before anything is
built. Then Custral builds it in your real workspace while you connect your
inbox, choose when Stella joins meetings, and invite your team.

The workspace you set up here is the one you keep, trial or paid.

> [!TIP]
>
> Want to try ideas without touching it? Make a [sandbox](https://docs.custral.com/start/sandboxes/overview.md)
> from **Settings → Sandboxes** at any point after setup.

## How it works

The setup runs in two parts.

1. **Design.** You describe the business, Stella drafts a setup, and you change
   it until it looks right. A pane on the right shows what will be made, grouped
   the way your sidebar will be. Nothing is created yet.
2. **Build.** **Looks good, build it** starts the build. It runs in the
   background, ticking each line off in the pane, while the remaining steps
   (marked **While we build**) ask for the things only you can give: your
   mailbox, your meeting preferences and your teammates.

When the build finishes, the workspace opens on its own and the
[interface tour](https://docs.custral.com/start/onboarding/sandbox-tour.md) starts.

## Using it

**1. Sign up and confirm your company**

Start from [custral.com](https://custral.com) with your work email or
Google. After the verification code, Custral looks your company up from your
email and asks **Is this your company?**, with the **Workspace name**,
**Industry** and **Your workspace address** filled in for you to check.
Confirming creates the workspace.

**2. Tell us about your business**

**Tell us about \<workspace>** asks what the business does (prefilled from
your website when it can be found), **Who are your customers?** (Businesses,
People or Both), **What do you do with customers?** (Sell to them, Onboard
them, Support them, Renew and upsell, Market to them, Build the product) and
what you use for each today. **+ Anything specific Stella should know** adds
a free-text note. Click **Draft my setup**.

Rather start from a fixed starting point? **Rather pick a standard setup?**
opens **Pick a standard setup** instead of drafting one. If you signed up
from a template on [custral.com/templates](https://custral.com/templates),
this step is skipped and the setup starts from that template.

**3. Review the setup**

**Here's \<workspace>'s setup** lists what Stella made. From here you can:

* type into **Ask Stella to change something** ("add a Renewals pipeline",
  "rename Deals to Opportunities"). Each change is listed, and can be undone;
* add Stella's other ideas under **Want these too?**;
* open **Full preview** in the right pane to see every page at full size and
  edit it directly;
* keep or untick **Add sample data so you can see it working**.

Click **Looks good, build it**.

**4. Bring your conversations in**

**Connect email and calendar** links a Google or Microsoft mailbox, and the
workspace fills itself in from it: the people you've talked to, your
meetings, and the companies they belong to. Only you can see the email
Custral syncs, unless you share it. **I'll connect later** asks you to
confirm, because the workspace then starts with no contacts from your mail.

**5. Choose when Stella joins meetings**

**Should Stella join your meetings?** offers **Meetings with people outside
\<workspace>**, **Only meetings I host**, **All my meetings with other
people** or **Don't join automatically**, and the name the other people in
the call see. Stella joins as a participant, so everyone in the call sees
it.

**6. Invite your team**

**Invite your team** takes email addresses, a team for each (from the teams
Stella set up) and a role. It is optional: **Skip for now** moves on.

**7. Add a card, if your offer needs one**

A sign-up from an offer with a checkout (a trial that needs a card, for
example) asks you to pick a plan and **Add card and start your trial**.
Other sign-ups skip this step.

**8. Open the workspace**

**How did you hear about us?** is the last, optional question. The workspace
opens as soon as the build has finished; until then the screen reads
**Opening \<workspace>**.

## Sample data

With **Add sample data so you can see it working** ticked, the build adds a few
made-up companies, deals and tickets to your own workspace so the pages aren't
empty on day one. An orange **Sample data** strip across the top of the app
says how much there is, so nobody takes it for real.

To clear it, a workspace admin clicks **Remove** in that strip and confirms
**Remove sample data?**. Only the sample records, conversations and tasks are
deleted. Everything you added yourself stays.

## Joining a workspace that's still being set up

If a teammate invites you while the build is still running, you see
**\<workspace> is being set up** with the note "Your workspace's owner is
setting it up." The setup belongs to the owner or an admin. You get in as soon
as it is built.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| **Draft my setup** shows "Tell us what \<workspace> does" | The first box is empty | Stella drafts around what the business does, so it can't be blank. Write a sentence, or use **Rather pick a standard setup?** |
| "Stella couldn't make that change" | Stella couldn't apply the request to the draft | Say it another way, or make the change yourself in **Full preview** |
| "That's all the changes Stella can make here" | The setup step allows a limited number of Stella changes | Make the rest yourself in **Full preview**. Nothing is built until you click **Looks good, build it** |
| The right pane shows an error and **Try again** while building | A build step failed | Click **Try again** in the pane. The build only adds what's missing |
| Google warns "Google hasn't verified this app" when you connect | Google is still approving Custral's app | The setup says so above the button. Click **Advanced**, then **Go to Custral** to continue |
| The workspace has no contacts after setup | The mailbox step was skipped | Connect a mailbox any time from **Settings → Connected Accounts** |
| You can't remove the sample data | Only workspace admins can remove it | Ask an admin to click **Remove** in the **Sample data** strip |
| You see "\<workspace> is being set up" and can't get in | You joined before the owner finished | Wait for the build to finish; the owner or an admin runs the setup |

> [!NOTE]
>
> When reporting an issue, include the request id shown in the error toast. It
> links the in-app error to the server logs.

## Related

* [Guided tours](https://docs.custral.com/start/onboarding/sandbox-tour.md): the interface tour that runs
  when the workspace opens, and the guided tours you can start later.
* [Home](https://docs.custral.com/start/home.md): where you land once setup is done.
* [Workspace settings](https://docs.custral.com/start/onboarding/workspace.md): change the company profile,
  hours and logo after setup.
* [Migration](https://docs.custral.com/start/onboarding/migration.md): import the data you already have.
* [Sandboxes](https://docs.custral.com/start/sandboxes/overview.md): a test workspace for trying changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.