Getting started
Onboarding
Which company a new project goes into, the four setup steps, and what we read from your website along the way.
Which company the project goes into
Every project is created inside a company, and it counts against that
company's plan, not against anything of yours. Setup shows which company it
will use: the one named by the link that opened setup (New project
under a company in the project switcher, or on the company's Projects
page), else the company of the project you have open when you are a member
of it, else the first company you are a member of. You can pick another of your
companies or A new company instead, with a name that starts as your
own.
Someone who is a member of no company yet gets a new company, created
together with the project
(api/services/company_projects.py#resolve_target_company).
A new company is refused while a company you created has no paid or comped
plan, since each person gets one Free company; setup then leaves out the
new-company choice and says which company to add the project to or upgrade
instead (api/services/company_projects.py#refuse_second_free_company).
Create a company on Your profile
opens setup with a new company already chosen.
Before the first step
Setup opens on its first step unless the chosen company is already at its
plan's project limit: the limit compares the company's active projects,
whoever created them, with the number its plan includes
(api/services/limits.py#check_project_limit). At that limit the page says
so before you type anything, naming the company, its plan's limit and how
many active projects it already has, with links to Manage projects and
See plans, and, when you have another choice, the company picker so a
different company can take the project. Paused projects do not count, so
pausing one of the company's projects frees a place. A company whose numbers
are missing is not blocked here (frontend/src/lib/onboarding.js#atProjectCap).
Whatever the page shows, creating the project runs the same check again on the server
(api/routers/projects.py#create_onboarding_project).
If you already have a project to go back to, in one of your companies or shared with you, a Back to the app link sits above the steps. A first-time user has no such link, because the app would only send them back here.
The four steps
Setting up a project is four steps, in order. Continue stays disabled until the current step is filled in; the last step is the one exception, because it is optional. Back returns to the previous step without losing what you entered.
Website
The site you want to track, entered with or without https://. The address
first has to look like a real web address, a host with a dot and a
plausible domain ending; otherwise the field says so.
Once it does, and you pause typing, DiscoveredBy reads your homepage once,
from its own servers, and shows what the page says about itself: its title,
its description and the address it ended on after any redirects. Nothing
else comes back from that read, and the request is guarded so it can only
reach public addresses (api/routers/projects.py#preview_project_site).
The card notes when the homepage redirects to another site altogether: the
project still tracks the address you typed.
The read is a check, not a gate. Many sites turn automated requests away, so
when the homepage cannot be read the card says why and that you can still
continue; when the check itself cannot run just now, for example because
checks are rate-limited per user, it says that and you can still continue.
The one answer that stops you is an address with no registrable public
domain to file the project under: creating the project would refuse it by
the same rule, so step 1 refuses it first
(api/routers/projects.py#_project_domain).
This step also suggests a project name taken from the domain ("acme-widgets.co.uk" becomes "Acme Widgets"), which only you and your team see and which you can rename before continuing. The site itself cannot be changed once the project exists, so it is worth getting right here.
Business
What the project is about: a business type chosen from a fixed list of verticals, which is required, an optional one- or two-sentence description of what you sell and who buys it, and at least one country to track from. A few common countries are offered as chips, and the search box finds any of the rest. Growth Advisor, llms.txt Advisor and Article Writer all read the business type and description before they generate anything. The agent that proposes new prompts works differently: it re-derives its own read of your business from a fresh site crawl rather than reading what you typed here (see Business Profiler). Each prompt you add in the next step is tracked once per country selected here.
If the list of business types or the list of countries cannot be loaded,
this step says which and offers Retry in place of the fields, rather
than an empty list that could never be passed; what you typed on the first
step is kept (frontend/src/routes/onboarding/+page.svelte#step2Missing).
Prompts
The questions you want tracked, in your buyers' own words: what someone would actually ask an AI engine, not a keyword. Add your own, or tap one of the suggested examples shown for your business type. At least one prompt is required before you can continue.
Each prompt takes one prompt slot per country, and the footer does the arithmetic as you go: how many slots this setup needs and how many the company's plan has free, across all of its projects. If the setup needs more than are free, Continue stays disabled and the footer asks you to drop a prompt or a country, or upgrade. See Plans and limits for how slots are pooled.
Competitors
Optional. Add a competitor's site and DiscoveredBy compares their showing
in the same answers against yours. The step shows how many competitors the
company's plan allows per project and stops adding at that number; on a
plan without competitor tracking it says so and lets you finish. Creating
the project refuses your own domain as a competitor. Each competitor is
named from its domain; when your brand or an earlier competitor already
answers to that name, it is named by its full domain instead, since one name
answers for one brand only, and you can rename it later in Settings → Brands
(api/routers/projects.py#create_onboarding_project). You can skip this step
entirely and add competitors later.
When you finish
Start tracking creates the project with its countries, prompts and
competitors in one request, in the company setup shows, or together with
a new company when you chose one; if that fails, the reason shows beside
the button and nothing is half-created
(api/routers/projects.py#create_onboarding_project).
Finishing opens Overview with a Your project is set up banner: your
prompts run in the next daily scan, at most a day from now, and results
appear on Overview after it, with a link to
how the first scan works. Dismiss
it with its close button; it appears only after finishing setup, never on
an ordinary sign-in
(frontend/src/routes/(app)/+page.svelte#showWelcome,
frontend/src/lib/server/post-login.js#establishSession). If you were on
your way to Billing when you signed in, finishing setup opens Billing
instead.
What we read from your site
Step 1 reads your homepage once, for the preview described above, and only its title, description and final address come back. None of it is saved to your project.
Once your project is created, the Business Profiler reads your site for real. It crawls your homepage and a handful of the pages it links to and works out a business type, target countries and focus keywords from what it finds. That reading is not applied to your project: today it exists to produce a starting set of prompts, and nothing else about it reaches your project settings.
The part you can act on is those prompts. They show up on Prompts → Suggestions as suggestions you review one at a time: nothing is added to your tracked prompts until you accept a specific one.
Changing your answers later
Business type, description and target countries can all be edited after setup, by a company member, from the project's settings (Project settings in the sidebar, or Open settings beside the project on the company's Projects page), and competitors from Settings → Brands (see Brands and sub-brands). The prompts you added live on their own screen instead: manage them from Prompts, not from Settings. Setup creates them as written, in no particular language; a default language for new prompts is set later, in the project's settings (see Projects). The one exception across all of it is the site URL itself: that is fixed at creation and does not change from there.
Related
- Create your account: signing in, what a project and a company are, and creating a company
- Plans and limits: what the company's plan covers, and how projects and prompt slots pool across it
- Your first scan: what happens to the prompts you just added
- Projects: every field on the project record, and who can change it
- Business Profiler: the agent that reads your site and stages a starter set of prompts
Last verified 2026-11-02