Import survey questions from CSV
Use the CSV importer to add several questions to a new or existing Survey campaign. The importer creates editable drafts in the campaign form. Nothing is saved until you click Create Campaign or Save Changes.
Expected result
- In a new survey, imported questions replace the untouched starter question. Otherwise, every valid CSV question is appended as an editable draft.
- Configured active and archived questions remain unchanged.
- Console opens Questions (n) and selects the first imported question.
- No imported data is saved until you save the Survey campaign.
Import survey questions in Console
- Create or edit a Survey campaign.
- In Survey or Questions, click Import from CSV.
- Click Download template, or download the survey question CSV template.
- Keep every column header exactly as supplied.
- Replace the example rows with your questions and save the file as CSV.
The template uses these columns:
| Column | What to enter |
|---|---|
| Question Type | One of single_choice, multiple_choice, rating, nps, short_text, long_text, or consent. A value in this column starts a new question. |
| Question Prompt | The question customers see. |
| Help Text | Optional supporting text shown below the prompt. |
| Required | true, false, yes, no, 1, or 0. A blank value defaults to required. |
| Survey Page | A positive whole number. A blank value defaults to page 1. |
| Question Key | Optional stable API/reporting key. Console generates it from the prompt when blank. |
| Option Label | The answer text shown to customers. Choice questions need at least two option rows. |
| Option Key | Optional stable option key. Console generates it from the label when blank. |
| Option Value | Optional reporting value. A blank value defaults to the option key. |
For a choice question, put the first option on the question row. Add more options on following rows with Question Type left blank. Continuation rows may contain only option fields. Rating, NPS, text, and consent questions must not contain option data.
Upload and review questions
- Click the upload area and choose the CSV file.
- In Review imported survey questions, inspect every question, page, required state, key, and option.
- Correct the CSV and upload it again if any question is marked Invalid.
- When every question is valid, click Add questions to campaign.
The import is atomic: Console does not add any questions while one or more rows are invalid. Imported questions are always new, active questions; the CSV cannot update IDs, archive questions, or replace questions you have configured. In a new survey, Console removes the untouched blank starter question when it applies the import.
Review and save imported questions
After the import, Console opens Questions (n) and selects the first imported question. Use the searchable question cards to review each full editor. Archived questions remain in the count and are identified by their lifecycle badges.
The Tips & guidance panel remains visible on the Questions and Reward Methods tabs so you can see any campaign setup tasks while reviewing imported questions and rewards.
- Review each imported prompt, answer type, page, and choice options.
- Resolve any campaign-form validation messages.
- Configure the survey reward and other campaign settings.
- Click Create Campaign or Save Changes.
Leaving the campaign form before saving discards the imported drafts.
If something looks different
- Check that the headers match the downloaded template exactly.
- Make sure every non-empty group starts with Question Type.
- Add at least two options to each single-choice or multiple-choice question.
- Remove option data from non-choice questions.
- Use a unique active question key. A key belonging only to an archived question can be reused.
- Keep page numbers positive and use one of the accepted Required values.