> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/review-candidates/candidate-sourcing.md).

# Candidate sourcing

Add candidates to JOIN yourself, from a CV you received elsewhere or from a LinkedIn profile with the JOIN Talent Sourcing Chrome extension.

There are three ways candidates can appear in your JOIN account:

1. **Automatic sourcing** – When a candidate applies to your job via a multiposted platform (e.g. job boards), their application is automatically added to JOIN.
2. **Manual sourcing** – You add a candidate yourself via the `Candidates` tab or directly in the `Applications` sub-tab inside a job.
3. **Chrome Extension sourcing** – You import candidates directly from LinkedIn using the JOIN Talent Sourcing Chrome Extension.

This article covers the last two options: **manual** and **Chrome Extension** sourcing. If you've received an application outside JOIN (e.g. via email, referral, or LinkedIn), you can manually add the candidate to your job to keep your pipeline complete and in one place.

This is done through the `Add candidate` option.

Sourcing candidates directly into JOIN allows you to:

* Keep all candidate data in one place
* Keep promising profiles found outside job boards
* Track sourcing channels (manual, referral, LinkedIn, etc.)
* Handle GDPR consent through automated consent requests
* Move sourced candidates through the same pipeline as other applicants

***

## Add a candidate manually

Add a candidate manually when you’ve received a CV outside JOIN, for example through referrals, events, or networking. Once added, the candidate appears in your `Applications` tab for the relevant job, and you can manage them like any other applicant.

### Add from the Candidates tab

1. Go to the `Candidates` tab
2. Click the `Active` sub-tab
3. Click `Add candidate` in the top-right corner
4. Select `Add manually` from the dropdown
5. In the `Add candidate` pop-up:
   * Enter the candidate’s email address and click `Continue`
   * Fill in the required fields:
     * `First name`
     * `Last name`
     * `Source` (how the candidate came to you)
   * Optionally add:
     * `Phone number`
     * `CV` (PDF, DOC, DOCX, TXT, or RTF)
     * `Cover Letter`
6. Click `Continue` to complete the submission

{% hint style="info" %}
Once added, the candidate receives a Consent Request email automatically. You can customise this email in `Settings` > `Emails` (under `Templates`).
{% endhint %}

### Add from a specific job

1. Go to the `Jobs` tab and select the relevant job
2. Click the overflow menu <i class="fa-square-ellipsis">:square-ellipsis:</i> in the top-right corner
3. Hover over `Add candidate` and select `Add manually`
4. Follow the same steps as above to complete the candidate form

Manually added candidates are tagged with `Manually imported` and their consent status is shown in the application view.

***

## Add a candidate with the Chrome extension

The Chrome Extension lets you import candidate profiles directly from LinkedIn into JOIN.

{% hint style="warning" %}
The extension only works on LinkedIn profiles. It doesn't activate on other websites.
{% endhint %}

### Install the extension

You can reach the Chrome Extension setup from three places in JOIN:

* The `Candidates` tab > `Add candidate` > `Chrome extension`
* Any job’s <i class="fa-square-ellipsis">:square-ellipsis:</i> overflow menu > `Add candidate` > `Chrome extension`
* `Settings` > `Chrome extension` (under `Platform`)

All paths redirect you to the Chrome Web Store page. You can also open it directly: [JOIN Talent Sourcing – Chrome Web Store](https://chromewebstore.google.com/detail/join-talent-sourcing/ejhbogofejeijcndmcehmaagmpijieic) <i class="fa-link">:link:</i>

<figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FIgTYGPRZO2Rssf3jSv1M%2Fadd-extension-to-chrome.png?alt=media&amp;token=8af45a40-5511-4bf2-b3be-8b3cd82bd449" alt=""><figcaption></figcaption></figure>

1. On the Chrome Web Store page, click `Add to Chrome`.
2. Confirm by clicking `Add extension`.
3. Log in to JOIN and open your LinkedIn account when asked, to connect the extension.
4. Once set up, open any LinkedIn profile: the JOIN widget appears on the right-hand side of the page.

### Import a candidate from LinkedIn

<figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FuDFJXzMJJh4YRoVExtNr%2Fezgif.com-animated-gif-maker.gif?alt=media&amp;token=5f0e6a8e-86da-42c2-990f-ac6cb5dac953" alt=""><figcaption></figcaption></figure>

Once the extension is installed and active, you can start importing:

1. Go to the LinkedIn profile of the person you want to add as a candidate.
2. Click the `Add talent` button that you see when you hover over the JOIN extension widget.
3. If the LinkedIn user has made their information public (see LinkedIn's help on [visibility of your email address on LinkedIn](https://www.linkedin.com/help/linkedin/answer/a523134/visibility-of-your-email-address-on-linkedin)), the widget automatically fetches details such as: Name, Email, Phone number, LinkedIn URL, Location
   * If some of this information is not public, those fields stay empty.
   * If no email is available, you're prompted to add one manually before proceeding.
4. Select the relevant job from the dropdown list.
   * If you have no active jobs, the widget asks you to create one before continuing.
5. Click `Import`.
6. JOIN tries to import the candidate:
   * If successful, you see a confirmation screen with the candidate’s details. Click `View candidate profile` to open their application in JOIN.
   * If the candidate already exists for that job, you see a message with an option to go directly to their application.
   * If the import fails, an error message appears and you can try again.
7. Once imported, the candidate is marked in JOIN as `Added via Chrome Extension`.

{% hint style="info" %}
A Consent Request email is automatically sent to candidates sourced using the Chrome Extension. Once candidates give consent, you can process and manage their application within JOIN.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.join.com/review-candidates/candidate-sourcing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
