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

# Form Editor

> Add questions to a form, choose where each answer is saved, then preview, translate, publish and restore earlier versions.

[Job candidate forms](https://docs.spott.io/docs/settings/job-candidate-forms.md) and
[candidate forms](https://docs.spott.io/docs/settings/candidate-forms.md) are built in the same editor. To open
it, go to **Settings → Templates**, select **Job Candidate Forms** or **Candidate Forms**,
and click a form. To start a new one, see
[create a job candidate form](https://docs.spott.io/docs/settings/job-candidate-forms.md#create-a-job-candidate-form)
or [create a candidate form](https://docs.spott.io/docs/settings/candidate-forms.md#create-a-candidate-form).

## Add elements to the form

Click **+ Add to form** and choose an element. It is added to the form, and its settings
open in the panel on the right. Click any element on the form to edit it, or drag it to
change the order or to place two questions next to each other.

![The Add to form menu with layout, candidate details, documents, consent and your own questions](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-add-to-form.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=1c1f495e94cc0d0675a8c78b2e444714)

| Group | Elements | What it's for |
| - | - | - |
| **Layout** | Heading, Text, Divider | Structure the form. A heading can have an icon. In a text block, type `/` to add headings, lists, a table or a horizontal rule. |
| **Candidate details** | First name, Last name, Email, Phone number, LinkedIn profile, Date of birth, Location | Standard profile details. Each one already saves to the matching field on the candidate. |
| **Documents** | Resume / CV, Cover letter, Other document | File uploads, saved to the candidate. |
| **Consent** | Privacy consent | Records a consent on the candidate. See [add a consent question](#add-a-consent-question). |
| **Your own question** | Text, Number, Date, Email, Phone number, Link, Single choice, Multiple choice, Checkbox | Questions of your own. You choose where each answer is saved. |
| **Custom attribute** | Any custom attribute | Asks for one of your [custom attributes](https://docs.spott.io/docs/settings/customizing-candidate-profiles.md) directly. |

An element that is already on the form is greyed out in the menu.

## Question settings

Every question has the same basic settings:

* **Label**: the question the candidate sees.
* **Help text**: shown under the question.
* **Placeholder**: example text in the empty field.
* **Required**: the form can't be submitted without an answer.

Under **Answer**, the settings depend on the answer type:

| Answer type | Settings |
| - | - |
| **Text** | **One line** or **Paragraph**, and **Maximum characters** |
| **Phone number** | **Default country** |
| **Date** | **Earliest date** and **Latest date** |
| **Multiple choice** | **Show as** a list or a dropdown, **How many can they pick?** (any number, up to, exactly, at least or between), and the **Options** |
| **File upload** | **Maximum files** and **Accepted formats**: PDF, Word, spreadsheet or image. CVs and cover letters only take PDF and Word files. |
| **Consent** | **Consent text**, from settings or your own |

## Choose where the answer goes

**Where the answer goes** shows the field that stores the answer, such as
**Candidate → Phone number** or a custom attribute. Candidate details and documents are
linked to their field already.

* To save the answer to your own question, click **+ Save to a field** and pick the field.
* To save the same answer to a second field, click **+ Also save to…**.
* An answer that isn't saved to a field is **Only kept on the submission**. It is not added
  to the candidate profile.

![A phone number question that saves to Candidate, Phone number, with the setting for existing candidates](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-where-answer-goes.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=c1c7c9e107d94105c9a8da13ed9f7d8d)

**If the candidate is already in Spott** decides what happens when the person filling in
the form matches a candidate you already have:

* **Add to it** adds the answer to what is already on the profile.
* **Keep the current value** leaves the existing value as it is.

The name, email, phone and LinkedIn of an existing candidate are never overwritten.

### Link options to attribute values

When a choice question saves to a custom attribute with set values, such as a
**Driving licence** attribute, each option is linked to one of those values. Spott lists
the attribute's values that aren't on the form yet. Click a value to add it as an option,
or **Add all** to add them all at once.

An option can save several values to a multi-select attribute, or none. If the question
also saves to a second attribute with **Also save to…**, choose a value for that attribute
under each option too, or leave it on **Saves nothing**.

![A multiple choice question whose options each save a value to two custom attributes](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-option-values.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=cd5f96261a6bb087237a23b7e5290d26)

## Add a consent question

Add **Privacy consent** from the **Consent** group. It is required by default.

* The **Label** only names the question inside Spott. Candidates see the consent text.
* Under **Consent text**, **From settings** uses the **Consent Disclaimer** from
  [Settings → General](https://docs.spott.io/docs/settings/general.md#branding-of-public-pages), in every
  language. To translate the text, choose **Own text** and write it for this question.
* Under **Where the answer goes**, the answer **Records a consent on the candidate**.
  Choose the **Purpose**, such as Recruiting, the **Framework**, such as GDPR, and how
  long it is **Valid for**.

The consent appears on the candidate like any other. See
[consent management](https://docs.spott.io/docs/settings/gdpr-consent.md).

![A privacy consent question that records a Recruiting consent under GDPR, valid for 2 years](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-consent-question.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=d0c0e3b842b504310a134e090ad7c052)

## Form texts

Click **Form texts** to set the form's **Title**, the label of the **Submit button**, and
the **Message after submitting**.

## Preview the form

Click **Preview** to see the form the way candidates see it. Switch languages at the top of
the preview. Submitting the preview checks the answers like the real form, but nothing is
sent.

![The preview of a form, with a language selector at the top and the submit button at the bottom](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-preview.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=eddcd4b823fb473a59d6e39ca0f0afbb)

## Translate the form

Every form has a **main language**, chosen when you create it. That is the language you
write and edit the form in.

1. Click **Translations**, then **+ Add languages**, and choose a language.
2. Fill in the translation of each text. Spott already fills in standard texts, such as
   **First Name**. Check them and change them if needed.
3. Use the **Needs work**, **Missing** and **Outdated** filters to find the texts that are
   left.
4. Click **Save translations**.

![The Translations window for Dutch, with 9 of 16 texts translated](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-translations.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=8a7aaa5ba955d4d035553b2ab639d0d1)

A text without an up-to-date translation shows in the main language. When you change a
text in the main language, its translations are marked **Outdated**.

To check a language, pick it in the language selector next to **Form texts**. You can only
edit main-language texts on the form itself; other languages are edited in
**Translations**. To remove a language, select it in **Translations** and click **Remove**
next to its name, for example **Remove Dutch**.

> [!NOTE]
>
> Spott doesn't check that a translation is written in the right language. Check the form
> in each language before you publish.

## Publish the form

Spott saves your changes as a draft as you go. Candidates don't see them until you
publish. Click **Discard draft** to throw away unpublished changes.

1. Click **Publish**. Spott lists what changes for candidates, including languages with
   missing translations. You can publish now and translate later, or click
   **Update translations** first.
2. Click **Publish** to confirm.

![The Publish this form window, listing Dutch with 7 missing translations](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-publish.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=2a36fa0b96fc9c30053b09ebe2ee25c9)

To change a published form, click **Edit form**. Candidates keep seeing the published
version until you publish again.

A published job candidate form is not used for applications until you
[make it active](https://docs.spott.io/docs/settings/job-candidate-forms.md#make-the-form-active). A published
candidate form can be [sent](https://docs.spott.io/docs/settings/candidate-forms.md#send-the-form-to-a-candidate)
straight away.

## Restore an earlier version

Click **History** to see every time the form was published, when, and by whom. Click
**View** to look at a version, or **Restore** to start a new draft from it. Publish the
draft to make that version live again.

![The History window with every published version of a form and its View and Restore buttons](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-history.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=be5844189bad60b1459d8350a4e0cf87)

## Rename, duplicate or archive a form

Click the **three dots** next to a form, in the list or at the top right of the form:

* **Settings** changes the form's name and main language.
* **Duplicate** creates a copy you can change.
* **Archive** removes the form from the list. Turn on **Show archived** to see archived
  forms.

For job candidate forms, the same menu holds **Make active**.

![The menu of a job candidate form with Make active, Settings, Duplicate and Archive](https://mintcdn.com/spott-docs/1Eeub4rED1cvK_jy/images/settings/forms-actions-menu.webp?fit=max\&auto=format\&n=1Eeub4rED1cvK_jy\&q=85\&s=866d3135ae31baddf0e3561be83270c7)


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