How to Generate a Survey with AI or Import a Document
The survey creation dialog can build a form from a prompt or extract one from a PDF or Markdown document. Both routes produce draft content that you review before it becomes part of the survey.
Before you start
- Decide the form's presentation mode (multiple questions per page or one question at a time); the dialog asks for it during creation.
- For document import, have a text-based PDF or a
.mdfile of at most 2 MB. A scanned image PDF has no extractable text; run OCR on it first. - Reviewing generated content takes longer than generating it. Plan for it.
Step 1: Start a new survey
- From the workspace, select New Survey.
- Give the survey a name and description.
- In the form section of the dialog, choose how the form is created:
- Create a new empty form;
- Create a form using a prompt;
- Import from a document (PDF or Markdown);
- or skip the form and add one later.
Step 2: Generate with a prompt
- Select the prompt option.
- Write the prompt. Say what the survey is for, who answers it, and the shape you want — for example: "Create 3 pages with 2 sections each. Page 1 covers the respondent's neighborhood; page 2 covers transport; page 3 covers accessibility of local services. Use plain language."
- Confirm.
Generation uses a language model and may take a little time. The result is a draft structure: pages, sections, questions and text.
Step 3: Import from a document
- Select the document option.
- Upload a PDF or
.mdfile (2 MB maximum). - Confirm.
The platform extracts the document's text and builds a draft form from its structure. It does not invent content the document does not contain, but it also does not preserve the source layout exactly.
Step 4: Review the generated content
Generated items are marked as pending review. Do not publish before reviewing them.
- In Compose, open the prompt menu in the toolbar.
- Select Filter generated content to show only the items that still need validation, with their ancestors for context.
- Open an item and validate it individually, or use the prompt menu:
- Accept all validates every item still pending review.
- Reject all marks every pending item removed and unlinks it from the tree.
- Turn the filter off to see the whole form again.
Accepting marks the content validated; it does not publish anything. Rejecting removes the generated items, not the questions you wrote yourself.
Step 5: Edit what the model produced
Generated content is a starting point, not a finished instrument. Before publishing:
- Read every generated question aloud; awkward phrasing is common.
- Replace invented answer options with ones that match your population.
- Check the question type against what the label asks for — the Review panel flags mismatches.
- Add logic, translations and accessibility modes deliberately; the model does not know your respondents.
- Run Review to catch plain-language, link-text and question-type problems.
- Test the form as a respondent.
Prompt history
Each generation is recorded in Build → Prompt (Advanced Mode), with the prompt text and parameters. Use it to see how a form was produced, or to repeat a generation with a refined prompt.
Limitations
- A prompt cannot know your legal, ethical or accessibility requirements; you must add them.
- Document import depends on the document's text quality; tables and multi-column layouts survive poorly.
- Generated translations are not a substitute for review by a speaker of the language.
- Generation may be metered on some plans; the dialog reports when it cannot run.
Related Content
- How to Review a Survey: Automated checks after generation.
- How to Edit a Survey: Working in the Compose tree.
- Prompt Reference: The prompt history.
- How to Test a Form: Trying the generated form.
- How to Choose a Form Layout: The presentation choice made during creation.