> ## 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.

# Manage jobs

> Create jobs, define who you are looking for, match candidates with AI, and run the pipeline to placement.

<div className="in-this-section">
  In this section you learn how to find and create jobs, define each role, use AI matching,
  manage candidates through the pipeline, attract applicants, and share progress with clients.

  <div className="section-links">
    1. [Search and filter jobs, create or import them](#1-search-and-filter-jobs-create-or-import-them)
    2. [Define who you are looking for in the Overview](#2-define-who-you-are-looking-for-in-the-overview)
    3. [Find the right candidate matches with AI](#3-find-the-right-candidate-matches-with-ai)
    4. [Understand the job pipeline](#4-understand-the-job-pipeline)
    5. [Create campaigns or advertising to attract inbound candidates](#5-create-campaigns-or-advertising-to-attract-inbound-candidates)
    6. [Make tracking easy for clients with the Company Portal](#6-make-tracking-easy-for-clients-with-the-company-portal)
  </div>
</div>

<div className="nav-hint">
  To open the Jobs page, click **Jobs** in the left-hand navigation bar.
</div>

<video className="w-full aspect-video rounded-xl" autoPlay muted loop playsInline controls preload="metadata" src="https://spott-media.b-cdn.net/docs/onboarding/v3/jobs-open-jobs.mp4" />

## 1. Search and filter jobs, create or import them

The **Jobs** page is where you search and filter your way to any existing role, and where
you create or import the ones that are not there yet.

### 1.1 Find jobs in the database

There are two ways to find the listing you are looking for: the search bar and the filters.

Use the **search bar** at the top of the Jobs page to find jobs using text from their
fields. For a more precise search, put exact phrases in double quotation marks and combine
them with **AND**, **OR**, or **NOT**.

Click **Filters** when you need to narrow the database by specific job information:

* **Status:** find jobs at a particular stage.
* **Location and company:** focus on roles for a specific place or client.
* **Users and team:** find jobs owned or supported by particular teammates.
* **Dates:** narrow by creation, start, end, or next task dates.
* **Employment details:** filter by location type or employment type.
* **Custom fields:** use the criteria created for your workspace.

You can also sort the database by fields such as job name, company, status, dates,
employment type, location type, or the next task due date.

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

### 1.2 Save a job view

Switch between **List** and **Board** view depending on how you want to review the database.
The same filters and sorting work in both layouts.

To save the setup as a view, click the current view name in the top right corner, such as
**Default view**, and select **+ Create new view**. Give the view a name, then save it so
you can return to the same filters, sorting, and columns later.

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

### 1.3 Create a job manually

Click **Add job** in the top right corner of the Jobs page to create a role from scratch.
Add the job title, company, and status, then include any available details such as
employment type, location type, salary range, description, and client contacts.

Click **Create job** to add the role to the Jobs list, then click its title to open the
**Overview** tab.

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

### 1.4 Import an existing job posting

If the vacancy already exists online, import it instead of typing it again. In the **Add new
job** dialog, use **Import from URL** to paste a public job posting link, or use the
[browser extension](/docs/settings/chrome-extension) to import the posting from the page you
are looking at.

Spott fills the job fields from the posting, and you can review or edit the information
before continuing.

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

<CardGroup cols={2}>
  <Card title="Searching jobs" icon="magnifying-glass" href="/docs/jobs/search-jobs">
    Filters, list and board view, and saved views.
  </Card>

  <Card title="Adding and managing jobs" icon="plus" href="/docs/jobs/adding-a-job">
    Create a job manually, from a URL, or by import.
  </Card>
</CardGroup>

## 2. Define who you are looking for in the Overview

The **Overview** tab is where you turn a new job record into a clear brief that your team
and Spott's AI can both use.

### 2.1 Set up the job in order

From the Jobs page, click the job title to open its **Overview** tab. Work through the setup
in this order, so each step gives the next one enough context:

1. **Files and notes:** attach the client's job description, and link briefing or intake
   notes to the job.
2. **Generate details:** click **Regenerate details** to create or improve the job
   information from the linked material.
3. **Details and fees:** confirm the requirements, locations, compensation, and the agreed
   fee structure.
4. **Client contacts:** link the people involved in the role.
5. **Scorecard:** create the evaluation template by hand, or generate it from the sourcing
   criteria.
6. **Ask AI:** ask questions once the job record holds the context the AI needs.

<Note>
  Notes are not linked to a job automatically. Open the relevant note and link it to the job,
  so it appears on the record and becomes available as AI context.
</Note>

### 2.2 Use the side panel while defining the role

Use **Details** in the side panel to review the job fields, create follow-up tasks, and
generate a scorecard. Open **Ask AI** when you need an answer based on the job's details,
notes, attachments, and sourcing criteria.

The sourcing criteria on the Overview tab power AI matching, so make the hard requirements
and the preferred qualities as specific as you can.

<video className="w-full aspect-video rounded-xl" autoPlay muted loop playsInline controls preload="metadata" src="https://spott-media.b-cdn.net/docs/onboarding/v3/jobs-overview-side-panel.mp4" />

<Card title="Job overview reference" icon="clipboard-list" href="/docs/jobs/job-details">
  The six-step setup flow: files and notes, details, fees, contacts, and the scorecard.
</Card>

## 3. Find the right candidate matches with AI

Once the job brief is complete, use **Matching** to find new candidates whose profiles fit
the role.

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

### 3.1 Run a job search

Open the job and select **Matching**, then click **Start new job search**. Spott turns the
job's description, notes, and sourcing criteria into suggested pre-filters and criteria.

Review them with **Edit criteria**, make any changes you need, then click **Run search**.

<Note>
  Matching looks for new candidates and leaves out anyone already in the job's pipeline. Use
  the **Candidates** tab to review the people already linked to the role.
</Note>

### 3.2 Use pre-filters and criteria correctly

Spott uses pre-filters and criteria for different parts of the search:

* **Pre-filters** are hard requirements a candidate has to meet before Spott ranks them,
  such as job title, field of study, keywords, or years of experience.
* **Criteria** are natural-language qualities used to rank the remaining candidates, for
  example "Business-level fluency in French".

Use **Match all filters** to require every pre-filter, or switch it off when candidates can
meet any of them. Spott shows how many candidates pass the filters, so you can widen them if
the pool is too small.

Criteria are numbered by priority: the ones higher in the list weigh more heavily in the
match score. Drag a criterion to change its position, click **×** to remove it, or select
**Add criteria** to create another one.

<Tip>
  Use pre-filters for the requirements that must be true, and criteria for the qualities you
  want to compare. Keywords belong in the pre-filters, not as a criterion of their own.
</Tip>

### 3.3 Review and act on the results

Start with the candidates who have the highest match scores. Click a score to review Spott's
reasoning, and open the candidate profile before you decide.

<Note>
  Match scores assess the AI criteria only. Every candidate in the results has already passed
  the pre-filters, including the ones with a weak score.
</Note>

From the results you can:

* **Review candidates:** compare their overall score and their rating for each criterion.
* **Add strong matches:** move suitable candidates into the job pipeline.
* **Refine the search:** edit the pre-filters or criteria and run it again.
* **Change the layout:** use Card view for deeper reading, or Table view for faster
  comparison.

Use **Search history** to reopen an earlier search instead of rebuilding it.

<Card title="Job matching reference" icon="wand-magic-sparkles" href="/docs/jobs/matching">
  Card and table views, search history, and sharing a search.
</Card>

## 4. Understand the job pipeline

The **Candidates** tab shows everyone linked to the job, and where each person is in the
hiring process.

### 4.1 Review the pipeline

Open a job and select **Candidates**. Use **Board view** to move candidate cards through
stages visually, or **List view** when you need a sortable, filterable table.

Drag a card to move a candidate between stages, or drop it into the rejected group to reject
the candidate at their current stage. That keeps stage-conversion reporting accurate without
needing a separate rejected stage.

Select several candidates with the checkboxes when you want to take the same action on all
of them. You can:

* **Update the pipeline:** move candidates to a stage, change their label, or reject them.
* **Organise candidates:** add them to another job or to a list.
* **Contact candidates:** send an email, present them, or enroll them in a
  [campaign](/docs/outreach/campaigns).
* **Share with the client:** publish them to the Company Portal.

<Note>
  Pipeline stages are configured for the whole workspace rather than per job. To change them,
  open **Settings → Stages**, and remember the change affects every job using that pipeline.
</Note>

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

### 4.2 Add candidates to a stage

Click **+** on the stage where the candidate should start. Search for an existing candidate,
or select **Upload CV** to create a new one, then click **Add to job**.

<Frame>
  <img src="https://mintcdn.com/spott-docs/9Q5zDbUG9mqD9No8/images/onboarding/jobs-add-to-stage.webp?fit=max&auto=format&n=9Q5zDbUG9mqD9No8&q=85&s=2550b0024def8e9456a1bcb807b8298f" alt="Adding a candidate to a pipeline stage" width="2672" height="1522" data-path="images/onboarding/jobs-add-to-stage.webp" />
</Frame>

### 4.3 Work from the application record

Click a candidate card to open the application that connects that person to this job. The
application holds the activity feed, your team's internal thread, Ask AI, scorecards,
meetings, and quick actions for the next step.

From the application you can send an email, add a note or a scorecard, present the
candidate, publish them to the Company Portal, or mark them as rejected or placed.

<iframe className="w-full aspect-video rounded-xl" src="https://video.gospott.com/video/sebastiens-video-4pxq/embed" title="Quick actions on an application card" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" allowFullScreen />

<Note>
  A candidate is only marked as placed once you complete the required placement information,
  including the fee details and the fee splits.
</Note>

<CardGroup cols={2}>
  <Card title="Job pipeline reference" icon="diagram-project" href="/docs/jobs/job-pipeline">
    Cards, view settings, and bulk actions.
  </Card>

  <Card title="The application record" icon="file-lines" href="/docs/jobs/applications">
    Upcoming meetings, interview buttons, and the internal thread.
  </Card>
</CardGroup>

## 5. Create campaigns or advertising to attract inbound candidates

Use campaigns to approach people already in your database, or advertise the job publicly
when you want candidates to apply themselves.

### 5.1 Create a campaign for the job

If campaigns are enabled for your workspace, use the job's **Campaigns** tab to enroll
selected profiles in a sequence of messages and reminders. You can also create and manage
campaigns from **Campaigns** in the left-hand navigation bar.

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

### 5.2 Write or generate the vacancy

Open the job and select **Advertising**. Write or paste the vacancy description, or click
**Generate job description** to create it with AI from the job details.

Use **Ask AI** in the side panel to refine the tone, requirements, length, or language before
publishing.

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

### 5.3 Choose where to publish

<Tabs>
  <Tab title="Spott job board">
    The Spott job board showcases your open positions online and receives applications
    directly into Spott. In the right-hand panel:

    * Switch the **Spott job board** toggle to **Open** to publish the vacancy. You can set
      it back to **Closed** at any time.
    * Pick the **inbound applications stage** where new applicants should land.
    * Use **Preview** to see the posting as candidates will, and **Copy link** to share the
      application link.
  </Tab>

  <Tab title="LinkedIn">
    Connect an existing LinkedIn Recruiter job posting so its applicants flow into Spott. See
    [connecting a LinkedIn job board post](/docs/jobs/linkedin-job-posting).
  </Tab>

  <Tab title="Multiposters">
    With a multiposter integration enabled, distribute the vacancy to many job boards at
    once:

    * [Broadbean](/docs/integrations/broadbean)
    * [Idibu](/docs/integrations/idibu)
    * [VDAB](/docs/integrations/vdab), for the Flemish public job board

    Multiposting uses **your own commercial account** with the multiposter. Posting credits,
    per-board fees, and pricing are handled with the multiposter, not Spott.
  </Tab>
</Tabs>

<Warning>
  Closing a job in Spott does not close its published adverts. Close each advert separately,
  or configure an automation, so a filled role stops receiving applications.
</Warning>

### 5.4 Review inbound applications

Open the job's **Inbound** tab to review the people who applied through the Spott job board,
LinkedIn, or a multiposter. Spott links each application to the job, enriches the candidate
data, and queues the person for review.

For each applicant you can:

* **Review the AI score:** open the score to see the assessment for each criterion.
* **Accept the candidate:** move one or several applicants into the pipeline stage you
  choose.
* **Reject the candidate:** reject the application, and choose whether to keep or delete the
  candidate's database record.

To reject someone and email them at the same time, click **Send email** first and use the
rejection toggle in the message composer. That closes the application and sends the
explanation in one step.

<Note>
  An inbound applicant only receives a match score after you have run a search on the job.
</Note>

<Frame>
  <img src="https://mintcdn.com/spott-docs/9Q5zDbUG9mqD9No8/images/onboarding/jobs-inbound.webp?fit=max&auto=format&n=9Q5zDbUG9mqD9No8&q=85&s=736fcbe07ca9b4a98229b82bbd716fda" alt="The Inbound tab on a job, with AI scores" width="2672" height="1522" data-path="images/onboarding/jobs-inbound.webp" />
</Frame>

<CardGroup cols={2}>
  <Card title="Advertising reference" icon="bullhorn" href="/docs/jobs/job-portal">
    The job board, branding, and where the posting appears.
  </Card>

  <Card title="Inbound applications" icon="inbox-in" href="/docs/jobs/inbound-applications">
    Review, accept, and reject, including rejection emails.
  </Card>
</CardGroup>

## 6. Make tracking easy for clients with the Company Portal

The **Company Portal** gives selected client contacts a secure, real-time view of the
candidates you choose to share.

### 6.1 Publish candidates to the portal

Open the job and select **Company Portal**. Publish one candidate with **Publish on
portal**, or select several candidates in the pipeline and choose **Add to company portal**.

If you want candidates to appear automatically, enable **Show all candidates in real time**
and choose which pipeline stages should publish to the portal.

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

### 6.2 Configure client access

Use the panel on the right to open or close the portal, invite client contacts, preview
their experience, and choose which candidate fields they can see.

<Note>
  Only contacts registered under the company associated with the job can be invited to its
  Company Portal.
</Note>

Clients can review candidates, comment, and request an interview. They cannot move
candidates between stages, reject them, or bulk-export files.

<Frame>
  <img src="https://mintcdn.com/spott-docs/9Q5zDbUG9mqD9No8/images/onboarding/jobs-portal-client-access.webp?fit=max&auto=format&n=9Q5zDbUG9mqD9No8&q=85&s=62db760c47d88276e4bec9b463196f2e" alt="Configuring client access to the Company Portal" width="2672" height="1522" data-path="images/onboarding/jobs-portal-client-access.webp" />
</Frame>

### 6.3 Track client feedback

Open **Activity** inside the Company Portal for a running log of what your client did:
who was invited to the portal, which candidate they commented on and what they said, and
the impression score they left on a candidate.

<Note>
  The feed records what a client **does**, not what they look at. There is no indicator for
  whether a particular profile has been opened, so a candidate with no comment and no
  impression has not necessarily been skipped.
</Note>

<Frame>
  <img src="https://mintcdn.com/spott-docs/9Q5zDbUG9mqD9No8/images/onboarding/jobs-portal-activity.webp?fit=max&auto=format&n=9Q5zDbUG9mqD9No8&q=85&s=9c79d1f44b16589287677cbcf95a6e49" alt="Client activity inside the Company Portal" width="2672" height="1522" data-path="images/onboarding/jobs-portal-activity.webp" />
</Frame>

The job record also keeps its **Files**, **Notes**, **Tasks**, and **Communication** beside
the portal, so the internal context stays attached to the same role.

<Frame>
  <img src="https://mintcdn.com/spott-docs/7oxKKaWrYsvpRbxH/images/onboarding/jobs-files-notes-tasks.webp?fit=max&auto=format&n=7oxKKaWrYsvpRbxH&q=85&s=ae0222438fb9ccf087109b646d3cbce8" alt="The files, notes, and tasks tabs on a job" width="2998" height="1618" data-path="images/onboarding/jobs-files-notes-tasks.webp" />
</Frame>

<Card title="Company Portal reference" icon="building-user" href="/docs/jobs/company-portal">
  Inviting contacts, what clients can do, and activity tracking.
</Card>

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

  * [ ] Create a **job list view** using two filters
  * [ ] Create a **new job**
  * [ ] Have the **Note Taker** join a briefing call, or add briefing notes to the job
  * [ ] **Generate details** and a job description with AI
  * [ ] **Post the job** on the portal
  * [ ] Apply **AI matching** to your candidates, and add one hard filter
  * [ ] **Add candidates** to the job pipeline
</div>

<Card title="Next: manage clients" icon="arrow-right" href="/docs/onboarding/manage-clients">
  Companies, contacts, and business development.
</Card>
