Survey Settings Page (Configuring Your Survey)

Last updated: April 16, 2026

Configure your survey's questions, email delivery, and activation status from the Settings page.

Who this is for: All users, Admins

Overview

The Survey Settings page is where you build the core of your survey: the questions respondents will see, the email they'll receive with the survey link, and the on/off toggle that controls whether the survey is live. It's typically the first place you go after creating a new survey.

Activation

The Active/Inactive toggle at the top of the Settings page controls whether your survey is live. When the survey is active, newly added recipients receive their survey email. When it's inactive, the survey is paused and no new emails are sent.

Before activating, make sure you've completed:

  • Adding at least one question

  • Setting the email subject line

  • Sending a test email to verify delivery and design

Email Configuration

Subject line — Enter the subject line recipients will see in their inbox. Limited to 200 characters. Write something specific and action-oriented; vague subject lines significantly reduce open rates. For example: "How was your experience with your recent return?" outperforms "We'd love your feedback."

Test email — Use the test send option to deliver a copy to your own email address before activating. This lets you verify the survey link works, confirm the subject line looks right, and see exactly what the respondent experience looks like.

Questions

You can add multiple questions to a single survey. There's no hard limit on question count, but shorter surveys with dynamic AI follow-ups enabled on open-text questions consistently outperform longer ones — brevity with targeted follow-ups increases completion rates while ensuring you still get rich answers where it matters.

Managing Questions

  • Reorder — Drag the six-dot handle on the top left of any question card, or use the up/down arrows on the top right to move it one position at a time.

  • Delete — Click the trash icon on the top right of the question card.

Each question has the following options:

Question Types

Type

When to Use

Rating (1–10)

NPS, CSAT, or any scored metric on a 1–10 scale

Open-Ended Text

Free-form written responses — best paired with AI follow-ups

Single Choice

One selection from a defined list of options

Multiple Choice

Select all that apply from a defined list of options

Yes / No

Binary questions where a simple yes or no is sufficient

Matrix Table

Rate multiple items on a consistent scale in a single question block — useful when you want feedback on several dimensions at once (e.g., rate the quality, fit, and value of a product) without asking separate questions for each

Dynamic AI Follow-Ups

Each question has a toggle to enable Allow AI Follow Up. When enabled, Unwrap may ask the respondent a follow-up question after they answer — but only under two conditions:

  1. The toggle is on for that question

  2. The respondent's answer is low in detail — if the AI determines the response is sufficiently specific and complete, no follow-up is asked. Follow-ups only fire when additional enrichment is warranted.

When a follow-up does trigger, it references the respondent's actual answer and preceding answers to ask a targeted clarifying question. For example, if a respondent writes "the product is uncomfortable," the AI might follow up with "Can you give specific examples or elaborate on how the product was uncomfortable?" Every follow-up is generated uniquely for that response — no two are the same.

Additionally, a net promoter will get a different question from a detractor on a successive question. For example, a promoter who answers "color" would get asked why they liked the color,

This means follow-ups don't add guaranteed length to your survey. A respondent who gives a detailed answer moves on without seeing one at all.

Follow-ups are most valuable on open-text questions. For structured questions like multiple choice or matrix, leave the toggle off.

System Prompt

You can include a system prompt on any follow-up-enabled question to give the AI context that shapes how it asks follow-ups. You can find this by clicking Admin Config on the Surveys Dashboard page. Use this to:

  • Describe the company or product the survey is about ("This survey is for customers of Deckers Outdoor, a footwear brand")

  • Specify topics to go deeper on ("If the respondent mentions comfort or fit, probe for specific product details")

  • Specify topics to avoid ("Do not ask follow-up questions about pricing or competitor products")

The system prompt is never shown to respondents — it only influences how the AI frames its follow-up question.

Personalization Parameters

You can personalize question text using dynamic placeholders that pull from recipient data. Use the format {parameter_name} anywhere in a question, where parameter_name matches a column header in your recipient CSV exactly.

Example:

"How satisfied are you with your experience returning {product_name}?"

If the recipient's CSV row includes product_name: Product X, they'll see: "How satisfied are you with your experience returning Product X?"

Rules for parameters:

  • Parameter names can only contain letters and underscores — no spaces, hyphens, or numbers (e.g., {product_name} is valid; {product name} and {product-name} are not)

  • The same naming rule applies to metadata keys when using the API — use product_name, not productName or product-name, so keys align with question parameters

  • Every recipient must have a value for each parameter used — blank values will cause the placeholder to appear literally in the question text

  • Parameters must match CSV column headers (or API metadata keys) exactly, including capitalization

Best Practices

  • Enable dynamic follow-ups on your open-text question. This is the single highest-leverage setting in Surveys — it turns a brief comment into a detailed conversation without adding survey length.

  • Write your rating question first, open text second. Respondents who give a score are primed to explain it when asked immediately after.

  • Test with your own email address before adding real recipients. You can't un-send an email.

  • Use personalization parameters to increase relevance. A question referencing the specific product or interaction a customer had will feel more relevant and get more detailed responses.

Limitations

  • Branching logic (routing respondents to different questions based on their answer) is not yet available. All surveys follow a linear question sequence.

  • Question edits made after recipients have been added do not apply to those recipients — they receive a snapshot of the survey at the time they were added.

FAQ

Q: Can I reorder questions after adding them?

A: Yes. Drag the six-dot handle on the top left of any question card to reposition it, or use the up/down arrows on the top right to move it one position at a time.

Q: How many questions can I add to a single survey?

A: There's no hard limit, but shorter surveys with dynamic AI follow-ups enabled on open-text questions consistently outperform longer ones. Aim for brevity — let the AI handle depth on the questions where it matters, rather than adding more questions to compensate.

Q: What does the dynamic follow-up question look like to the respondent?

A: After the respondent submits their answer to a follow-up-enabled question, they see a new text field appear with a follow-up question generated specifically for their response. It feels conversational — not like a separate survey page.

Q: Can I use the same survey for multiple recipient batches over time?

A: Yes. You can add new recipients to an active survey at any time. Each batch receives the version of the survey that exists when they're added.

Related Articles