---
title: Questionnaires
slug: questionnaires
docTags: oo6xaePJsHqgcYrO9ByiT
createdAt: 2025-07-10T11:52:40.796Z
---

Ashby provides a way to send [questionnaires](https://app.ashbyhq.com/admin/organizational-settings/surveys/questionnaire) to your candidates. These help you collect information during various stages in the application process, rather than asking questions up front in the application form.

# Permissions & access

Questionnaires are available on all Ashby plans. The number of questionnaires you can create varies by plan.

| Foundations | Legacy Plus | Plus | Enterprise |
| ----------- | ----------- | ---- | ---------- |
| ✅\*         | ✅           | ✅    | ✅          |

\***Foundations:** Limited to 1 questionnaire. Plus and Enterprise plans support custom, unlimited questionnaires.

The table below shows which access roles can configure and send questionnaires.

| Access Role                                                    | Can configure surveys? | Can send surveys to candidates? |
| -------------------------------------------------------------- | ---------------------- | ------------------------------- |
| Limited Access                                                 | ❌                      | ❌                               |
| Agency Users                                                   | ❌                      | ❌                               |
| Elevated Access - External Recruiter (not linked to an agency) | ❌                      | ❌                               |
| Elevated Access - Analyst                                      | ❌                      | ❌                               |
| Elevated Access - Hiring Team Member                           | ❌                      | ❌                               |
| Elevated Access - Hiring Manager                               | ❌                      | ✅                               |
| Elevated Access - Admin                                        | ❌                      | ✅                               |
| Elevated Access - Admin (Private)                              | ❌                      | ✅                               |
| Organization Admin                                             | ✅                      | ✅                               |

# Questionnaires overview

Ashby supports the ability to send questionnaires to candidates at any stage of the hiring process. You can create and customize any number of questionnaires and configure how and when to collect them from candidates.

Some use cases for questionnaires include:

- Asking a candidate about their dietary preferences prior to an onsite lunch
- Asking a candidate for references prior to the Offer stage
- Deferring questions asked in the Application Form to later stages of the process to streamline the application process

# Set up your questionnaire

You can set up questionnaires in the [Admin Section](https://app.ashbyhq.com/admin/organizational-settings/surveys/questionnaire) of the app. Navigate to **Admin > Jobs & Applications > Candidate Surveys**, then select the `Questionnaires` tab.

Click `+ New` to create a new questionnaire.

![You can create new questionnaires and edit their questions in the Admin Section of the app. You can also configure Automation Settings to set up rules to automatically schedule emails with links to the questionnaires.](https://cdn.zappy.app/e4392d4164a7a3a272c19fbcb294ae87.png)

You are prompted to give your new questionnaire a title before you can add questions.

Click `Add Question` and select a question type to build out your questionnaire.

You can select the following field types:

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
- Short Answer
- Long Unformatted Answer
- Phone
- Email
- Multiple Choice
- Checkboxes
- Date
- Yes/No
:::

:::VerticalSplitItem
- Number
- Resume
- Linear Rating
- NPS Rating
- Candidate's Location
- Other Location
- URL
- File
:::
::::

# Send a questionnaire

Questionnaires can be sent in two different ways:

## Directly request questionnaire completion from the candidate profile

You can directly request the candidate to complete a questionnaire:

1. On the candidate profile, click the `More` dropdown.

![Screenshot of the candidate profile showing the More dropdown menu](https://cdn.zappy.app/34a2bbbc223628f353e86a5aaf054a26.png)

2. Select `Create a Questionnaire Request`.

![Screenshot of the Create a Questionnaire Request dialog](https://cdn.zappy.app/d1d1b81a927b4f4a48cd3e8dffcaa70a.png)

3. Choose which questionnaire to send and which application it should be associated with.
4. Create the questionnaire request using the `Create` button, or optionally also schedule an email with a link to the questionnaire using the `Create and Email` button.

## Automate rules to schedule sending the questionnaire to a candidate when certain conditions are met

You can set up automation rules so that you don't need to directly request questionnaires from candidates manually. Instead, you can set up a series of conditions that trigger automatically sending a questionnaire to a candidate.

To configure automation settings for your questionnaire:

1. Create a new draft configuration of automation rules by clicking `Get Started`.
2. Specify your conditions by clicking `+ Add Field to Match`, choosing fields, and then creating filters based on those.
3. Select an email template from the **Email Template** dropdown that will be used to send out your questionnaire.

:::hint{type="info"}
The email template must include the `Questionnaire Link` substitution token. In the email editor, select the `T` token button and search for “questionnaire” to add it. This token adds the candidate-specific questionnaire link to the email. The token is required to enable the automation and send the questionnaire email.
:::

4. Configure any email delay using the **Delay** dropdown.
5. Specify a sender email address.
6. Click `Save & Publish`.
7. Toggle on the `Enable Survey Automation` toggle once the draft has been activated.

![Automation Configuration screen showing a rule that sends the “Candidate Info - Get to Know You” survey after a candidate enters the “Trials of Skill” interview stage group, with a three-weekday delay at 9:00 a.m. CEST.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/8Os0wGi843ptlncZxSV-F_scroll-of-technical-mastery-questionnaire-ashby-2026-09-16-at-113846-am.jpg)

The conditions of each rule are checked whenever a candidate changes stages. Ashby finds the first rule that matches, creates a questionnaire, and schedules an email with a link to the questionnaire.

# Setting up automation for questionnaire activities on an interview plan

:::hint{type="info"}
When a candidate lands in a stage with a questionnaire activity, you can set the questionnaire request to be sent out automatically at that point.
:::

You can watch the video below for an overview, or follow the steps below.

::loom{url="https://www.loom.com/embed/cdc38bfb35ee454ba667da672a37805e"}

1. Navigate to the interview plan for your job.
2. Click `+ Add Activity`, then select the **Questionnaire** option.
3. Select your questionnaire and email template.
4. Check the `Automate on Stage Entry?` checkbox so the questionnaire is sent when the candidate is moved to the specified stage.

![Screenshot showing the Automate on Stage Entry checkbox in the questionnaire activity settings](https://cdn.zappy.app/79e054f205991308ce1299ce8235e45c.png)

When a candidate is moved to the stage your automation has been added to, you see a note that the automated activity is being started. You also have the option to undo this.

::Image[]{src="https://cdn.zappy.app/234a5e6c08a706c882fd0a59f9c585ce.png" size="80" alt="Screenshot showing the automated activity notification when a candidate moves to a stage with a questionnaire" isUploading="false" width="497" height="186" darkWidth="497" darkHeight="186" showCaption="false"}

# View your results

## Viewing individual results

You can view individual results of a completed questionnaire on the **Forms** tab on the candidate profile.

![Screenshot of the Forms tab on the candidate profile showing completed questionnaire results](https://cdn.zappy.app/85a62f41e8b0ea81dc229f07fc11d076.png)

## Reporting and analysis

You can report on the questions in a questionnaire in standard reports. The fields are available under **Job Consideration > Questionnaire**.

![Screenshot of the reporting interface showing questionnaire fields under Job Consideration](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/kBWje3ocm2fxJLj3HvVd7_screenshot2022-05-23at101434am.png)

## Reporting on questionnaire responses

Questionnaires are available as a subject to be reported on. Use this to count submitted questionnaires over a period of time, to review answers to specific questions, and more.

Here are the fields that can be used for filtering, grouping, or displaying information on your report. Select the questionnaire you are reporting on to access these fields for the specified questionnaire. You can also choose questions added to the questionnaire as reporting fields.

| **Field**    | **Definition**                                      |
| ------------ | --------------------------------------------------- |
| Submitted At | When the questionnaire was completed and submitted. |
| Title        | The name of the questionnaire.                      |

## Questionnaire report examples

### Pull a list of the answers submitted for a specific job

Navigate to **Reports > Report Builder**, then select `Custom List`.

**Subject:** Questionnaires

**Filters:** Questionnaire's Candidate's Job Consideration's Job.

**Fields to Show:** Candidate Name and all or any of the questionnaire questions you'd like to have included in your list.

![Screenshot of the Custom List report configured to pull questionnaire answers by job](https://cdn.zappy.app/4c2e9928455a4b24da40b376f6d7c12d.png)

:::hint{type="info"}
Custom list reports on questionnaires can also be exported to .csv using the `Export` button in the upper right corner of the report.

::Image[]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/hAxS4TWrTyeA3orzs9fOS_questionnaire-report-responses-bridget-s-test-report-ashby-2026-07-31-at-62225-pm.png" size="80" isUploading="false" width="1106" height="632" darkWidth="1106" darkHeight="632" alt="Screenshot showing the export button in the upper right of the report page." showCaption="false"}
:::

### View the number of questionnaires completed over the last quarter, split by week and grouped by questionnaire type

Navigate to **Reports > Build Report**, then select `Count Over Time`.

**Subject:** Questionnaires

**Time Field & Interval:** Submitted At to show Last Quarter every Week.

**Group By:** Questionnaire's Title.

![Screenshot of the Count Over Time report configured to show questionnaire completions over the last quarter](https://cdn.zappy.app/752f535892ff12cbc446afa478964439.png)

# FAQs

### Are questionnaire links public or reusable?

Links to complete questionnaires are candidate-specific. It currently isn't possible to create a public link for a questionnaire.

### Can I add file upload questions to my questionnaire?

Yes! Click `Add Question`, then select the `File` field option. You can then add the question and, optionally, a description.

### Can I send questionnaires to other users like interviewers or recruiters?

No, questionnaires can only be configured and sent out to candidates. Consider adding questions to feedback forms or setting up [Hiring Manager Experience Surveys](docId\:Fl73J4CypI6sF86H7Tzra).