> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/media-surveys/create-a-media-survey/add-questions-to-a-media-survey.md).

# Add questions to a media survey

Your mission relies on the questions you want to ask your participants. Questions guide participants through your unmoderated studies, and you’ll be able to analyze responses to each individual question when participants complete your mission.

Media surveys will always have **mission questions**, but they will also include **screener questions** if you’re auto-recruiting participants. Refer to the sections below for more information.

{% hint style="info" %}
**Tip:** For a list of available questions in media surveys, see [Question types in a media survey](/media-surveys/what-are-media-surveys-in-dscout/question-types-in-media-surveys.md).
{% endhint %}

## Screener questions (auto-recruit only)

When auto-recruiting participants, screener questions use knockout logic to qualify or disqualify applicants. These questions are presented to applicants first and ensure only those who meet your requirements can complete the rest of your mission.

{% hint style="info" %}
**Note:** In addition to screener questions, you’ll also want to include targeting attributes to narrow down your target audience even further. For more information, see [Targeting attributes](/recruit-participants/dscout-scout-panel/targeting-attributes.md).
{% endhint %}

**To add a screener question to your study:**

{% stepper %}
{% step %}
Navigate to the **Screener** tab of your mission.

![](/files/9772c023789ff033d18a6f248e438e85eb110e32)
{% endstep %}

{% step %}
Click **+ Add** under **Screener questions** in the left sidebar.
{% endstep %}

{% step %}
Select **Multiple choice** to add a new multiple choice question.

![](/files/f4bf29615668639ef3284bd14bca6b08d494d0a5)

{% hint style="info" %}
**Tip:** You can also select **Add from question bank** to add a saved question from your question bank. For more information, see [Question banks](/study-basics/question-types/question-banks.md).
{% endhint %}
{% endstep %}

{% step %}
Enter a **Prompt**.
{% endstep %}

{% step %}
Enter your answer **Choices**.
{% endstep %}

{% step %}
Configure your knockout logic using the drop-down lists beside each choice. For more information, see [Knockout questions](/recruit-participants/dscout-scout-panel/knockout-questions.md).

![](/files/b5116732473e509d8f5c775eb9fe1772b64ac196)
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, your screener question is added to your mission. Repeat the steps above to add more screener questions (up to 10 total) or move on to adding your mission questions.

## Mission questions

Mission questions are the heart of your media survey. This is where you’ll collect the bulk of your insights, and these questions will make up most of your analysis when you’ve collected responses. When auto-recruiting participants, only those who qualify based on your screener questions will see your mission questions, and they’ll be advanced here automatically if they qualify.

**To add mission questions to your media survey:**

{% stepper %}
{% step %}
Navigate to the **Media survey** tab of your mission.

![](/files/7ccf9a22ffde7fd27ab2dac6bcec5c2c0f4b03e6)
{% endstep %}

{% step %}
Click **+ Add** in the center of the builder or under **Questions** in the left sidebar.
{% endstep %}

{% step %}
Select a question type.

![](/files/40140d7e70590b34d9ee73e2e064a4ac2a2c8a84)

{% hint style="info" %}
**Tip:** You can also select **Add from question bank** to add a saved question from your question bank. For more information, see [Question banks](/study-basics/question-types/question-banks.md).
{% endhint %}
{% endstep %}

{% step %}
Complete the provided question fields.

{% hint style="info" %}
**Tip:** For more information on individual question settings, search for its question type on the Dscout help center.
{% endhint %}
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, your mission question is added to your media survey. Repeat the steps above to add as many questions as you need.

{% hint style="info" %}
**Tip:** Need help writing your question prompts? Dscout AI can help. For more information, see [Refine your questions](/dscout-ai/built-in-ai-features/refine-your-questions.md).
{% endhint %}

## Instructions and thank you

Dscout includes default instructions and thank you messages on every media survey. However, you can add a custom message at the start or end of your mission for a more personalized feel.

**To add custom instructions or thank you messages:**

{% stepper %}
{% step %}
Navigate to the **Media survey** tab of your mission.

![](/files/7ccf9a22ffde7fd27ab2dac6bcec5c2c0f4b03e6)
{% endstep %}

{% step %}
Select **Instructions** or **Thank you** in the left side bar.

![](/files/8235f11a74c2f3670b28ad19a36b9aeceb32b392)
{% endstep %}

{% step %}
Set the **Custom message** toggle to ON. The custom message field is displayed in the builder.
{% endstep %}

{% step %}
Enter your custom message.

![](/files/df06e0b1df9ff2713192b4511c6e454a245a6df3)
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, your custom message is added to your mission. Participants will see this at the start or end of your mission (or both!) depending on which you chose to configure.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.dscout.com/media-surveys/create-a-media-survey/add-questions-to-a-media-survey.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.