[Layouts](https://www.cv-transformer.com/fr/docs/layouts) [Variables](https://www.cv-transformer.com/fr/docs/layouts/variables)

# Variables

2 min de lecture

Variables are the parts of a layout that differ per candidate, such as their name, summary and work experience. The AI fills them in from the candidate's attachments, and recruiters can change them in the candidate editor. Manage them in the **Data** tab of the layout editor.

![The Data tab with the layout's variables, including lists such as experiences and educations](https://ddcaybdkekwxbpgpotoa.supabase.co/storage/v1/object/public/common/pages/3fbb9774-b3ec-44c6-8d50-4b1a834b6a75/layout-data.jpg)

## [Using variables](#using-variables)

Refer to a variable in a text element with its name between double braces, such as `{{name}}` or `{{job_title}}`. Dates can be formatted; see [Date formatting](https://www.cv-transformer.com/en/docs/layouts/date-formatting).

## [Variable types](#variable-types)

- **Inline text**: a single line, such as a name or job title.
- **Text block**: text with paragraphs and formatting, such as a summary.
- **Number**: a number, with an optional minimum and maximum.
- **Date**: a date, precise to the year, month or day.
- **Date range**: a start and end date, where the end can be **Present**.
- **Multiple choice**: one of the options you define, such as a level.
- **Image**: an image, such as the candidate's photo.
- **Rating**: a score, shown with a rating element.
- **List**: a list of items, such as work experience. Each item is a variable itself, often an object.
- **Object**: a group of variables, such as the title, company and period of one work experience.

## [Variable settings](#variable-settings)

Click a variable to change it:

- **Variable name**: the name you use in the layout. Give variables clear, consistent names in `snake_case`, such as `work_experience`; the AI uses them to understand what goes where.
- **Default value**: shown when a candidate has no value.
- **Precision** (dates): year; year and month; or year, month and day.
- **Options** (multiple choice): the choices, in each language of the layout.
- **Required length** (text and lists) and **Limits** (numbers): the editor warns when a value is too short, too long, too small or too large.
- **Visibility**: **Sensitive** variables are hidden in the anonymized proposal. See [Anonymization](https://www.cv-transformer.com/en/docs/layouts/anonymization).
- **Include in AI response**: turn this off for variables the AI shouldn't fill in, such as a field recruiters always fill in by hand. Add **Custom AI instructions** to tell the AI how to fill in this variable, such as "At most three sentences, in the third person".

Variables the layout doesn't use are marked **Unused**. The order of the variables is the order in which the AI fills them in, so sort them as they appear in the layout.

## [Built-in values](#built-in-values)

Besides the layout's own variables, every layout can use:

- `{{current_date}}`: the date of the export.
- `{{page.number}}` and `{{page.total}}`: page numbers, in a header or footer.
- `{{user.name}}`, `{{user.email}}` and the other details of the candidate's contact. Add your own details per team member, such as a phone number, under **Team** → a member → **Layout variables**; use them as `{{user.phone}}`.
- `{{external.…}}`: the candidate's data from your ATS, as described in [Field mapping](https://www.cv-transformer.com/en/docs/integrations/field-mapping).

[PrécédentBuilding blocks](https://www.cv-transformer.com/fr/docs/layouts/building-blocks) [SuivantStyling](https://www.cv-transformer.com/fr/docs/layouts/styling)