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

# Set up Spott (admin)

> Configure the workspace settings that apply to everyone: stages, labels, data model, features, access, and more.

Workspace settings define how Spott behaves for your entire organization. Updates here
apply to all users and shape both internal workflows and public-facing experiences.

<Note>
  This page is for admins. Every user should also work through
  [Set up Spott (user)](/docs/onboarding/setup-user) for their own account.
</Note>

## 1. Configure your workspace settings

### 1.1 General

Control your organization's core setup, including branding, public URLs, social links,
and privacy policy.

<Note>
  **Customize the consent disclaimer**

  By default Spott provides a [consent](/docs/settings/gdpr-consent) disclaimer shown at the bottom of all public forms.
  If you would rather use your own privacy agreement text, paste it into this section of
  the settings.
</Note>

<Card title="Workspace and branding reference" icon="palette" href="/docs/settings/general">
  Logo, favicon, accent colour, and the public-facing text.
</Card>

### 1.2 Stages

Customize the pipeline stages candidates move through in your jobs and speculative
presentations.

<video className="w-full aspect-video rounded-xl" controls playsInline preload="metadata" poster="/images/onboarding/clients-opportunity-stages-poster.webp" src="https://spott-media.b-cdn.net/docs/onboarding/v3/clients-opportunity-stages.mp4" />

The **Job stages** list is the pipeline candidates follow in a job, for example
Application, Long list, Short list, Outreach, Interview, Presentation, and Offer.

* Drag stages by the handle to reorder them.
* Click **Add stage** to create a new one, and use the row menu (the three dots) to
  rename or recolor it.

Two markers tell Spott how to measure your pipeline:

* **CV sent**: the stage at which a CV counts as sent to the client. This drives the
  "CV sent" reporting metric.
* **First interview**: the stage at which a first interview counts as completed.

The **Speculative presentation stages** define a separate pipeline for speculative
candidate presentations, managed the same way as job stages.

Beyond the recruiting workflow, you also set up:

* **Company stages**, for managing company relationships
* **Job statuses**, for tracking job progress
* **Opportunity statuses**, for your opportunity pipeline

<Card title="Pipeline stages reference" icon="diagram-project" href="/docs/settings/stages">
  Every stage list, plus sub-stages and closing-rate percentages.
</Card>

### 1.3 Labels

Create labels to categorize and report on notes, tasks, rejections, and emails across your
workspace.

<Frame>
  <img src="https://mintcdn.com/spott-docs/7oxKKaWrYsvpRbxH/images/onboarding/setup-admin-labels.webp?fit=max&auto=format&n=7oxKKaWrYsvpRbxH&q=85&s=d6090e526dcdf2b21821cf8b206caa0f" alt="The Labels settings, grouped by where each label is used" width="1600" height="837" data-path="images/onboarding/setup-admin-labels.webp" />
</Frame>

Spott groups labels by where they are used:

* **Note labels**: categorize notes, for example Follow up or Candidate interview.
* **Task labels**: categorize tasks so they surface in the right context.
* **Rejection labels**: standardize the reasons applications are rejected.
* **Email labels**: organize emails in the inbox, for example Submission or Offer.

Click **Add label** in a section to create one, give it a name and colour, and it becomes
available on the matching records.

<Card title="Labels reference" icon="tags" href="/docs/settings/labels">
  How labels feed filtering and reporting.
</Card>

### 1.4 Data model

The Data model lists every record type with the number of attributes it has: Candidates,
Jobs, Applications, Companies, Contacts, Opportunities, and Files. Click a record type to
manage its attributes.

<Frame>
  <img src="https://mintcdn.com/spott-docs/7oxKKaWrYsvpRbxH/images/onboarding/setup-admin-data-model.webp?fit=max&auto=format&n=7oxKKaWrYsvpRbxH&q=85&s=9782bee8931d67322499021d008eee61" alt="The Data model settings listing each record type and its attribute count" width="1600" height="747" data-path="images/onboarding/setup-admin-data-model.webp" />
</Frame>

Here is how to create a new attribute:

<iframe className="w-full aspect-video rounded-xl" src="https://video.gospott.com/video/create-a-new-attribute-79et/embed" title="Create a new attribute" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" allowFullScreen />

You can also set up AI-filled columns and let AI populate custom attributes based on
contact and candidate profiles.

<Note>
  **Starred attributes**

  Starred attributes appear by default on records, while unstarred ones stay available
  under **Show all values**. Drag attributes to set the order they appear in.
</Note>

<CardGroup cols={2}>
  <Card title="Data model reference" icon="table-columns" href="/docs/settings/data-model">
    Attribute types, and why a type is fixed once created.
  </Card>

  <Card title="AI-filled columns" icon="wand-magic-sparkles" href="/docs/settings/ai-filled-columns">
    When they generate, and how to refresh them.
  </Card>
</CardGroup>

### 1.5 Features

Enable or disable workspace-wide functionality such as enrichment, auto-updating profiles,
the unified inbox, and outreach campaigns.

<Card title="Features reference" icon="toggle-on" href="/docs/settings/features">
  What each feature switch turns on.
</Card>

### 1.6 Integrations

Connect Spott to external tools like calling providers and job board distributors used by
your team. All native integrations live under this tab.

<Card title="All integrations" icon="plug" href="/docs/integrations/overview">
  Email, calendar, telephony, messaging, job boards, and data providers.
</Card>

### 1.7 Import

See [Self-migration guide](/docs/onboarding/self-migration) to learn about the CSV import
function.

### 1.8 Automations

Trigger actions automatically on events in Spott: open dialogs at the right moment, send
emails, update fields, and more.

<Card title="Automations reference" icon="robot" href="/docs/settings/automations">
  Triggers, actions, enabling them, and the run log.
</Card>

### 1.9 Templates

Manage the reusable email, note, insight, and job description templates in your workspace.
Spott reuses these across the product, so your team stays consistent.

<Frame>
  <img src="https://mintcdn.com/spott-docs/7oxKKaWrYsvpRbxH/images/onboarding/setup-admin-templates.webp?fit=max&auto=format&n=7oxKKaWrYsvpRbxH&q=85&s=76398bfc5d07dbc57454406d8d3e43b3" alt="The Templates settings listing each template category" width="1600" height="927" data-path="images/onboarding/setup-admin-templates.webp" />
</Frame>

The available template types are:

* **Presentation email templates**: the prompt used to present candidates and jobs.
* **Email templates**: your personal and workspace
  [email templates](/docs/inbox/message-templates).
* **Note templates**: reusable note structures for your workspace.
* **Insight templates**: the instructions the AI uses to generate call insights. See
  [Spott Note Taker](/docs/notes/note-taker).
* **Job description templates**: the instructions the AI uses to generate job descriptions.
* **Placement forms**: the custom fields and layout used when logging a
  [placement](/docs/placements/placements).

Open any category to view, edit, or create templates within it.

<Card title="Templates reference" icon="file-lines" href="/docs/settings/templates">
  Every template type, and how Spott picks one.
</Card>

## 2. Control access rights

Spott offers Role-Based Access Control (RBAC), which improves security by assigning
permissions to roles so users only access what their job needs. The main restrictions
cover workspace settings, and delete, merge, and export operations.

### 2.1 Configure role-based access control

Under the **Security** tab you can create new roles.

<Frame>
  <img src="https://mintcdn.com/spott-docs/7oxKKaWrYsvpRbxH/images/onboarding/setup-admin-roles.webp?fit=max&auto=format&n=7oxKKaWrYsvpRbxH&q=85&s=acf524216b7a084a2365b17076e5ca54" alt="The Security tab with the list of roles" width="3024" height="1720" data-path="images/onboarding/setup-admin-roles.webp" />
</Frame>

For each role, use the toggles to turn on the features that role should have. For example,
you might give team leads access to workspace settings so they can create new fields,
while regular members cannot.

<Frame>
  <img src="https://mintcdn.com/spott-docs/7oxKKaWrYsvpRbxH/images/onboarding/setup-admin-role-permissions.webp?fit=max&auto=format&n=7oxKKaWrYsvpRbxH&q=85&s=7b57e9bd9e3257c71bb8665c02f8adc4" alt="The permission toggles for a single role" width="3022" height="1714" data-path="images/onboarding/setup-admin-role-permissions.webp" />
</Frame>

Once you have granted permissions to your roles, invite users with the orange button under
the **Users** tab, then assign them a role.

<Frame>
  <img src="https://mintcdn.com/spott-docs/AT0soKAVPCjamVvm/images/onboarding/setup-admin-users.webp?fit=max&auto=format&n=AT0soKAVPCjamVvm&q=85&s=4d47040c19bd5e03b1a029e0dd0b52c3" alt="The Users tab, with the Invite user button" width="1720" height="257" data-path="images/onboarding/setup-admin-users.webp" />
</Frame>

Each row shows the member's name and address, their **status** (`accepted` once they have
signed in, `pending` while an invitation is outstanding), the **roles** they hold, and the
date they joined. Roles are edited straight from the row, and a member can hold more than
one, for example **Team lead** alongside **Admin**.

<Note>
  Removing a user deactivates them rather than deleting the account, so their historical
  activity stays attributed to them.
</Note>

<CardGroup cols={2}>
  <Card title="Managing access" icon="lock" href="/docs/settings/managing-access">
    Roles, permissions, and workspace-wide MFA.
  </Card>

  <Card title="Managing teams" icon="users" href="/docs/settings/managing-teams">
    Offices and teams, and where you can filter by them.
  </Card>
</CardGroup>

## 3. Billing

<Card title="Get familiar with the Billing tab" icon="credit-card" href="/docs/onboarding/billing">
  Seats, credits, and topping up.
</Card>

## 4. To go further

### 4.1 API

Create and manage API keys to securely access Spott data and build custom integrations,
workflows, or applications. See the
[API reference](https://api-docs.spott.io) for available endpoints and usage examples.

### 4.2 Webhooks

Configure webhook endpoints to receive real-time notifications when events occur in Spott.
The [webhooks reference](https://api-docs.spott.io) lists the events currently available.

### 4.3 Verified domains

Manage and verify your sending domains for marketing campaigns and emails sent from
automations.

<Card title="Verified domains and deliverability" icon="envelope-circle-check" href="/docs/settings/domains">
  Set up your sending domain, plus best practices to boost deliverability.
</Card>

<div className="your-turn">
  ## Now your turn

  * [ ] Set your **branding** and consent disclaimer
  * [ ] Customize your **stages**, and set the CV sent and First interview markers
  * [ ] Create your **labels**
  * [ ] Review the **data model** and add the attributes you need
  * [ ] Turn on the **features** your team will use
  * [ ] Create your **roles** and invite your **users**
  * [ ] Verify your **sending domain**
</div>

<Card title="Next: check your billing" icon="arrow-right" href="/docs/onboarding/billing">
  Seats, credits, and what each AI action costs.
</Card>
