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

# Adding candidates

> The ways to get candidates into Spott — CV upload, email forwarding, manual entry, LinkedIn, CSV, integrations, and the API — and when to use each.

Spott gives you several ways to add candidates. The right one depends on what you have
in hand: a CV, a list to bulk‑import, or a LinkedIn profile you're sourcing from.

Open the **Candidates** page (shortcut: `G` then `A`) and click **Add Candidate** in the
top‑right. You'll see the upload dialog:

<Frame>
  <img src="https://mintcdn.com/spott-docs/p014P0_PfappR2TU/images/candidates/add-candidate-dialog.webp?fit=max&auto=format&n=p014P0_PfappR2TU&q=85&s=4278f08a110e24b4c03c134514ac991f" alt="The Add Candidate dialog with CV upload, email option, and manual entry" width="1600" height="956" data-path="images/candidates/add-candidate-dialog.webp" />
</Frame>

## Choose a method

<CardGroup cols={2}>
  <Card title="Upload a CV" icon="file-arrow-up">
    Drag & drop one or many CVs — Spott parses them and pre‑fills the form for you to review.
  </Card>

  <Card title="Forward by email" icon="envelope">
    Send CVs to `cv@spott.io` from your work email and Spott creates the candidates automatically.
  </Card>

  <Card title="Add manually" icon="keyboard">
    Enter the details by hand — best when you only have a name or partial info.
  </Card>

  <Card title="From LinkedIn" icon="linkedin">
    Import a profile directly with the [Spott Chrome extension](/docs/settings/chrome-extension).
  </Card>
</CardGroup>

The first three are the day‑to‑day workflows. CSV import, sourcing integrations
(e.g. [Juicebox](/docs/integrations/juicebox), [Pin](/docs/integrations/pin)), and the
API cover bulk and programmatic cases.

## Upload a CV (drag‑and‑drop)

The fastest way when you have CVs in hand. Spott parses each CV and drops you into the
candidate form with the fields already filled in.

<Steps>
  <Step title="Open the upload dialog">
    On the Candidates page, click **Add Candidate**.
  </Step>

  <Step title="Add your CVs">
    Drag files onto the drop zone, or click **Upload CV** to browse. You can add
    **up to 1,000 CVs at once**.
  </Step>

  <Step title="Review the parsed details">
    Spott extracts what it can — name, email, phone, LinkedIn URL, work experience,
    education, and certifications — and pre‑fills the form across the **Basic
    attributes**, **Experience**, **Education**, and **Certificates** tabs. Correct
    anything that needs it.

    <Frame>
      <img src="https://mintcdn.com/spott-docs/p014P0_PfappR2TU/images/candidates/add-candidate-parsed.webp?fit=max&auto=format&n=p014P0_PfappR2TU&q=85&s=2ac57cb3c8cb78cc9ff2b4d44fa07e2b" alt="A parsed CV pre-filled in the candidate form" width="1600" height="1289" data-path="images/candidates/add-candidate-parsed.webp" />
    </Frame>
  </Step>

  <Step title="Save">
    Click **Add All Candidates**. They now appear in your database.
  </Step>
</Steps>

<Note>
  CV upload is a **supervised** flow: you always review the parsed values before saving.
  If you'd rather skip the review step, forward the CV by email instead (below).
</Note>

## Forward CVs by email

Forward CVs as email attachments to `cv@spott.io` and Spott parses them and creates the
candidate records — no need to log in.

<Warning>
  **Forward from your work email** — the address you use to sign in to Spott. That address
  is how Spott knows which workspace the candidate belongs to. Forwarding from a personal
  address won't work.
</Warning>

This is an **unsupervised** flow — there's no review step, so an occasional field may be
missed. You'll always get an email back if something goes wrong:

<AccordionGroup>
  <Accordion title="No CV was attached">
    The email arrived without a CV attachment. Reply‑forward with the file attached.
  </Accordion>

  <Accordion title="The CV couldn't be read">
    The file was corrupted or image‑only without recognizable text. Re‑export a clean PDF and resend.
  </Accordion>

  <Accordion title="The candidate matched two different people">
    The CV's email, phone, or LinkedIn URL points to two different existing records, so
    Spott can't safely deduplicate. It surfaces the conflict instead of guessing — resolve
    it in the app. See [deduplication](/docs/candidates/managing-candidates).
  </Accordion>
</AccordionGroup>

## Add a candidate manually

Best when you have only a name, an email, or partial information — no CV.

<Steps>
  <Step title="Open the form">
    Click **Add Candidate**, then **Add Candidate Manually**.
  </Step>

  <Step title="Fill in the details">
    Enter name, email, phone, and location, then add **experience**, **education**, and any
    custom fields your workspace has configured.
  </Step>

  <Step title="Save">
    The candidate is created and added to your database.
  </Step>
</Steps>

## Other ways to add candidates

<CardGroup cols={2}>
  <Card title="LinkedIn (Chrome extension)" icon="linkedin" href="/docs/settings/chrome-extension">
    Import candidates and companies straight from a LinkedIn profile or search.
  </Card>

  <Card title="CSV import" icon="table" href="/docs/candidates/import-candidate-csv">
    Bulk‑upload a list of candidates from a spreadsheet.
  </Card>

  <Card title="Sourcing integrations" icon="plug">
    Push candidates from connected tools like Juicebox or Pin directly into Spott.
  </Card>

  <Card title="API" icon="code">
    Insert candidates programmatically via the Spott API.
  </Card>
</CardGroup>

## Good to know

* **Duplicates are handled for you.** Spott deduplicates on email, phone, and LinkedIn URL,
  so re‑adding someone enriches the existing profile rather than creating a copy. See
  [managing candidates](/docs/candidates/managing-candidates).
* **Keep profiles complete.** Fuller profiles improve search accuracy and matching results.
