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

# Candidate Forms

> Send candidates a personal link to a form you build, so they can update their profile, upload documents or give consent themselves.

A candidate form is a form you send to a candidate in an email or a campaign. Each
candidate gets a **personal link that works once**. Their answers are saved straight to
the fields you choose on their profile, so you don't have to chase and retype the
details.

Typical uses:

* **Collect documents**, such as an updated CV or an ID card, before a placement.
* **Fill in custom attributes**, such as availability, driving licences or preferred
  locations.
* **Run a consent campaign**: send a form with just a consent question to a list of
  candidates, and each answer records a consent on their profile.

Candidate forms work like the **Request updated CV** link described in
[updating a candidate profile](https://docs.spott.io/docs/candidates/update-profile-from-cv.md), except that you
decide which questions to ask.

![The Candidate Forms list under Settings, Templates](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-candidate-list.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=bd8d61302273a82535b9fc0ff7d56fb4)

## Create a candidate form

1. Go to **Settings → Templates** and select **Candidate Forms**.
2. Click **+ Create Form**.
3. Enter a **Name** for the form. This is also the name you pick when you add the form to
   an email.
4. Under **Start from**, choose **A blank form**, or an existing form to copy its
   questions. Answers are never copied.
5. Choose the **Main language**. This is the language you write and edit the form in.
   Texts that aren't translated into a candidate's language show in this language.
6. Under **Link valid for**, choose how long a candidate can open the link after you send
   it, for example 30 days.
7. Click **Create**.

![The Create Form window for a candidate form, with Link valid for set to 30 days](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-create-candidate.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=78fb9f2ebaad7277aa0e443ddb047049)

Unlike a [job candidate form](https://docs.spott.io/docs/settings/job-candidate-forms.md), a blank candidate form
starts empty. No question is mandatory, so ask only what you need.

## Build the form

Click **+ Add to form** to add headings, text, candidate details, documents, a consent
question or your own questions, and choose under **Where the answer goes** which field
stores each answer. The [form editor](https://docs.spott.io/docs/settings/form-editor.md) covers every element and
setting.

To ask for documents:

* **Resume / CV** saves the file as the candidate's CV. It only takes PDF and Word files.
* **Other document** saves the file to the document type you choose, such as **ID Card**.
  Under **Accepted formats**, choose PDF, Word, spreadsheet or image files, and set
  **Maximum files** to let the candidate upload more than one.

![The Add to form menu of a candidate form, with Cover letter and Other document under Documents](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-candidate-documents.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=43b739512c44538f459769b6542c5cf2)

When the form is ready, [preview](https://docs.spott.io/docs/settings/form-editor.md#preview-the-form),
[translate](https://docs.spott.io/docs/settings/form-editor.md#translate-the-form) and
[publish](https://docs.spott.io/docs/settings/form-editor.md#publish-the-form) it. Publish the form before you
send it.

## Send the form to a candidate

You add a candidate form to an email as a variable. When the email goes out, the variable
becomes the recipient's personal link.

1. Start an email to the candidate.
2. In the message, type `{` or click the **variables** icon, then select
   **Recipient → Forms** and choose your form. The variable shows as
   `{ Recipient > form name }`.
3. Click **Preview message** to check the email. The variable is replaced by the
   candidate's link.
4. Click **Send message**.

![The variable picker in an email, open on Recipient, Forms, with the Request updated CV link and two candidate forms](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-email-variable.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=00e1c2b090266e40bbb083398e7f83c1)

To send a form to many candidates at once, add the same variable to an email step in a
[campaign](https://docs.spott.io/docs/outreach/campaigns.md). Each recipient gets their own link.

> [!TIP]
>
> Add a short sentence around the link that says what you're asking for and why, for
> example "Please upload your ID card before your first day."

## What the candidate sees

The link opens the form on a page with your workspace branding, set in
[workspace and branding](https://docs.spott.io/docs/settings/general.md). The page shows the form's title and the
date until which the link works.

When the candidate clicks **Submit**, their answers are saved to the candidate profile. If
they open the link again, they see **You already filled in this form**.

### How the links work

* **Each link is personal** and works for one submission.
* **The link expires** after the period set in **Link valid for**, counted from when you
  send it.
* **One open link per form.** If you send the same form again before the candidate has
  filled it in, they get the same link, so they never have several links to the same form.
  Once they've submitted, the next email contains a new link.

## Related

> [card] [Job Candidate Forms](https://docs.spott.io/docs/settings/job-candidate-forms.md)
>
> Choose what applicants fill in when they apply to one of your jobs.

> [card] [Form Editor](https://docs.spott.io/docs/settings/form-editor.md)
>
> Every element and setting, translations, publishing and version history.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.