---
url: /surveys.md
description: >-
  How to create customer feedback surveys with radio, checkbox, and text
  questions, translate them for multiple languages, and view results.
---

# Surveys

**Surveys** let you collect feedback from customers during their ordering experience. Gather valuable insights about your audience, measure satisfaction, or collect marketing data.

## What are Surveys?

Surveys are optional questionnaires that appear during the customer's order flow. They can include:

* Multiple choice questions (single or multiple selection)
* Text response questions
* Up to 5 questions per survey

Responses are collected and visible in your campaign analytics.

## Creating a Survey

### Step 1: Basic Information

1. Go to **Set up → Surveys**
2. Click **Add Survey**
3. Fill in:
   * **Name**: Internal reference name
   * **Description**: Optional notes about the survey's purpose

### Step 2: Add Questions

1. Click **Add question**
2. Configure each question (see below)
3. Repeat for additional questions (maximum 5)

### Step 3: Assign to Campaign

1. Open your campaign
2. In **Linked Resources**, find **Survey**
3. Select your survey
4. Save the campaign

## Question Configuration

### Question Fields

| Field        | Description                                   | Required |
| ------------ | --------------------------------------------- | -------- |
| **Key**      | Unique identifier (letters, numbers, \_ or -) | Yes      |
| **Type**     | Question format                               | Yes      |
| **Required** | Must customer answer?                         | No       |
| **Label**    | Question text shown to customer               | Yes      |
| **Hint**     | Helper text below the question                | No       |

### Question Types

| Type           | Description                   | Best for                |
| -------------- | ----------------------------- | ----------------------- |
| **Radio**      | Single selection from options | "Which do you prefer?"  |
| **Checkboxes** | Multiple selections allowed   | "Select all that apply" |
| **Text field** | Free-form text response       | Open feedback           |

### Radio Questions

Customers select **one option** from a list.

**Example**:

* Label: "How did you hear about us?"
* Options: "Social media", "Friend", "Email", "Advertisement", "Other"

### Checkbox Questions

Customers can select **multiple options**.

**Example**:

* Label: "Which products interest you?"
* Options: "Photo prints", "Calendars", "Photobooks", "Postcards"

### Text Field Questions

Customers type a **free response**.

**Example**:

* Label: "Any additional feedback?"
* Hint: "Optional — share your thoughts with us"

## Multi-Language Support

Survey questions can be translated for each language your webapp supports:

1. Open your survey
2. Use the **language picker** to switch languages
3. Enter translated text for:
   * Question labels
   * Hint text
   * Option labels
4. Save your changes

::: warning
Make sure to translate all questions for each supported language. Untranslated questions will show blank or default text.
:::

## Managing Questions

### Reordering Questions

Use the up/down arrows to change question order. Questions appear to customers in the order shown.

### Deleting Questions

Click the delete icon to remove a question. This cannot be undone.

### Editing Options

For radio and checkbox questions:

* Click **Add option** to add choices
* Drag options to reorder them
* Click the remove icon to delete an option

## Viewing Results

Survey responses appear in your campaign dashboard:

### Survey Answers Chart

For radio and checkbox questions:

* Visual chart showing response distribution
* Percentage and count for each option
* Filter by date range

### Text Responses

For text field questions:

* Responses are collected but not shown in charts
* Can be exported with order data

::: info Chart Limitations

* Maximum 3 questions shown in the chart
* Text field questions are not displayed in charts
  :::

## Examples

### Customer Interest Survey

**Purpose**: Understand what brought customers to your campaign

**Questions**:

1. "How did you discover this promotion?" (Radio)
   * Social media, Email, Friend recommendation, Advertisement, Website
2. "What products would you like to see in the future?" (Checkboxes)
   * Canvas prints, Mugs, Phone cases, Magnets
3. "Any suggestions for us?" (Text)

### Brand Awareness Survey

**Purpose**: Measure brand recognition

**Questions**:

1. "Have you heard of \[Brand] before?" (Radio)
   * Yes, No
2. "Where have you seen \[Brand]?" (Checkboxes)
   * TV, Online ads, Store, Social media, Never seen before
3. "How likely are you to recommend \[Brand]?" (Radio)
   * Very likely, Likely, Neutral, Unlikely, Very unlikely

### Product Feedback Survey

**Purpose**: Gather product preferences

**Questions**:

1. "What's the main occasion for this order?" (Radio)
   * Gift, Personal use, Home decoration, Memory keeping, Other
2. "What size do you prefer?" (Radio)
   * Small, Medium, Large
3. "What other photo products interest you?" (Checkboxes)
   * Albums, Wall art, Calendars, Cards

## Best Practices

### Question Design

* Keep questions clear and concise
* Use neutral language (avoid leading questions)
* Limit to essential questions only
* Make most questions optional

### Options

* Provide comprehensive choices
* Include "Other" when appropriate
* Keep option lists manageable (5-8 max)
* Order logically (e.g., positive to negative)

### User Experience

* Fewer questions = higher completion
* Put most important questions first
* Use hints to clarify if needed
* Test the flow yourself

### Data Quality

* Use consistent keys for tracking
* Consider how you'll analyze responses
* Plan for multi-language responses

## Limitations

| Limit                        | Value |
| ---------------------------- | ----- |
| Maximum questions            | 5     |
| Maximum options per question | 10    |
| Text field character limit   | 500   |
| Questions in chart           | 3     |

## Common Questions

### Are surveys required?

Surveys are optional. You can run campaigns without any survey questions.

### Can I change surveys mid-campaign?

Yes, but be aware:

* New questions only apply to new orders
* Historical data won't include new questions
* Removing questions stops collecting that data

### Can I make all questions optional?

Yes. Use the "Required" toggle to control whether customers must answer.

### How do I export survey data?

Survey responses are included when you export order data from your campaign.

### Can I skip surveys for returning customers?

No, surveys appear for every order. Consider keeping them short.

## Related Topics

* [Campaigns](/campaign) — Assign surveys to campaigns
* [Orders](/orders) — View order data including survey responses