When setting up an interview in the HR portal, you can customize how the AI interviewer behaves using template variables. These are placeholders that automatically fill in with real data for each candidate.
Where Can I Use Variables?
You’ll find these text fields in the Interview Configuration section of your job posting settings:
| Field | Purpose |
|---|
| Prompt Intro | How the AI interviewer opens the conversation |
| Prompt Outro | How the AI interviewer wraps up |
| Additional Instructions | Extra behavioral guidance for the AI |
| Per-question Instructions | How the AI should ask or handle a specific question |
How to Use Variables
Wrap the variable name in double curly braces: {{ variable_name }}
Example — Prompt Intro:
Welcome the candidate by saying "Hi {{ candidate_first_name }}, thanks for
joining us for the {{ job_title }} interview at {{ company_name }}."
“Hi Jane, thanks for joining us for the Senior Backend Engineer interview at Acme Corp.”
Available Variables
Candidate
| Variable | What it contains | Example |
|---|
candidate_first_name | Candidate’s first name | Jane |
candidate_last_name | Candidate’s last name | Smith |
candidate_full_name | Candidate’s full name | Jane Smith |
Company
| Variable | What it contains | Example |
|---|
company_name | Your organization name | Acme Corp |
company_description | Your organization description | A leading SaaS company... |
Job Posting
| Variable | What it contains | Example |
|---|
job_title | Job title | Senior Backend Engineer |
job_description | Full job description | |
job_additional_information | Additional information from the posting | |
job_location | Job location | Berlin, Germany |
employment_type | Employment type | full_time |
salary_min | Minimum salary | 60000 |
salary_max | Maximum salary | 80000 |
salary_currency | Currency code | EUR |
salary_frequency | Pay frequency | yearly |
Interview
| Variable | What it contains | Example |
|---|
interviewer_name | The AI interviewer’s display name | Veo |
language | Interview language code | en |
language_name | Interview language | English |
is_phone_interview | Whether this is a phone interview | true / false |
interview_minutes | Estimated duration in minutes | 15 |
max_retakes | Maximum retakes allowed | 3 |
retake_number | Which attempt this is (0 = first) | 0 |
| Variable | What it contains |
|---|
cv_context | A summary of the candidate’s uploaded CV. Empty if no CV was uploaded. |
Conditional Text
You can show different text depending on the situation using {% if %} blocks:
Example — Adjust for phone interviews:
{% if is_phone_interview %}
Speak clearly and confirm the candidate can hear you before starting.
{% endif %}
{% if cv_context %}
The candidate's background: {{ cv_context }}
Use this to ask more relevant follow-up questions.
{% endif %}
Variables are resolved automatically for each interview. If a variable has no value (e.g. no CV was uploaded), it
will be empty.
Tips
- Keep it natural — the AI works best when instructions sound like guidance you’d give a human interviewer
- Don’t repeat job details the AI already knows — the job description, questions, and evaluation criteria are provided automatically
