> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate a form with AI

> Describe a survey, quiz, or live session in plain language and FormAI drafts the questions, welcome and end screens, and a matching theme.

Describe what you need and FormAI drafts the whole form for you. You then refine it in the editor or with [FormAI Agent](/user-guide/editor/edit-with-ai-agent).

<Frame caption="Describe the form, select Generate, and the questions stream into the editor.">
  <video autoPlay muted loop playsInline className="w-full" src="https://mintcdn.com/formai-app/XBaZxbZCaxkDZx0d/videos/create-with-ai.mp4?fit=max&auto=format&n=XBaZxbZCaxkDZx0d&q=85&s=1722f5d9664580b4d468dfe849a27fb7" aria-label="Opening the New form dialog, typing a prompt, selecting Generate, then watching questions stream into the editor after Building questions… and clicking through them" data-path="videos/create-with-ai.mp4" />
</Frame>

## Generate a form

<Steps>
  <Step title="Open the New form dialog">
    On the **Dashboard**, click **New form** at the top right. The **Create a new form** dialog opens with the subtitle "Describe it and FormAI drafts it — or start blank."

    <Frame caption="The Create a new form dialog, with example prompts under Try.">
      <img src="https://mintcdn.com/formai-app/XBaZxbZCaxkDZx0d/images/getting-started/create-form-dialog.jpg?fit=max&auto=format&n=XBaZxbZCaxkDZx0d&q=85&s=e19d6f1b5163655e9d2177f13a7a26df" alt="The Create a new form dialog on the Survey tab with an empty topic field, the Add context menu, and Try example prompts" width="1512" height="711" data-path="images/getting-started/create-form-dialog.jpg" />
    </Frame>
  </Step>

  <Step title="Choose a type and workspace">
    Pick **Survey**, **Quiz**, or **Live** from the tabs, and choose the workspace the form should live in using the selector on the right. See [form types](/core-concepts/form-types) if you are not sure which to pick.
  </Step>

  <Step title="Describe your form">
    Type your topic into the field marked "Draft your survey topic". The placeholder reads "Provide your form topic to generate relevant questions."

    Not sure what to write? Click one of the **Try** examples under the field to fill it in, then edit it.
  </Step>

  <Step title="Add context (optional)">
    Open the **Add context** menu to draft from a **PDF document** or a **Web page** instead of starting from a description alone. See [Add context](/user-guide/create/add-context).
  </Step>

  <Step title="Choose how many questions">
    Open the question count menu and pick a size. See [Question count](#question-count) below.
  </Step>

  <Step title="Click Generate">
    The editor opens right away with "Building questions…". In our testing the draft took about 20 to 30 seconds to appear.
  </Step>
</Steps>

<Accordion title="Write a stronger prompt" icon="lightbulb">
  The more FormAI knows, the closer the first draft will be. Try including:

  * **Audience.** Who is answering? For example, "customers who visited in the last month" or "new hires in their first week".
  * **Goal.** What do you want to learn or measure? For example, "find out what slows down checkout".
  * **Length.** How long should it be? You can also set this with the question count menu.
  * **Tone.** For example, "friendly and informal" or "formal and concise".
  * **Language.** Say which language the questions should be written in. You can also check **Form Language** in [form settings](/user-guide/settings/form-settings).

  Example prompt:

  > A short customer feedback survey for a neighbourhood coffee shop: overall satisfaction, favourite drink, service speed, and what we could improve.
</Accordion>

## Question count

The question count menu sets the size of the draft.

| Option | Use it for |
| - | - |
| **Up to 5 · quick pulse** | A fast check-in with a handful of questions. |
| **About 10 · standard** | A typical survey or quiz. |
| **15 or more · deep dive** | Longer research or a thorough quiz. |

<Tip>
  The dialog reminds you that "Surveys finish best under 8 questions — completion drops after that." Shorter surveys tend to get more complete responses.
</Tip>

## What gets generated

FormAI drafts a complete form, not just a list of questions:

* A **welcome screen** with a title and description.
* **Questions** of types that fit your topic.
* An **end screen** ("Thank you").
* A **matching theme** that fits your topic.

For example, the prompt above produced a welcome screen, five questions (a star rating, a multiple choice question about a go-to order, a satisfaction question, a 0 to 10 recommendation question, and an open text question), a thank-you screen, and a coffee-colored theme.

Your form saves automatically. A "Saved" indicator with the date and time appears above the preview.

## Review before you publish

<Note>
  AI can make mistakes. FormAI reminds you in the dialog: "AI can make mistakes — please review the generated content." Read every question, check the answer options, and confirm which questions are required before you publish. For quizzes, also check the correct answers in [Scoring and answers](/user-guide/quizzes/scoring-and-answers).
</Note>

## AI credits

Generating a form uses AI credits. Each plan includes a monthly AI credit allowance for your organization. Manual edits, publishing, sharing, collecting responses, and viewing results do not use credits. If you run out, AI actions pause, but published forms keep collecting responses. See [Plans and AI credits](/user-guide/account/plans-and-ai-credits) and [pricing](https://formai.app/pricing) for plan details.

## Next steps

<CardGroup cols={2}>
  <Card title="Add context" icon="file-pdf" href="/user-guide/create/add-context">
    Draft from a PDF or a web page.
  </Card>

  <Card title="Question types" icon="list-check" href="/user-guide/editor/question-types">
    See what each question type collects.
  </Card>

  <Card title="Edit with FormAI Agent" icon="wand-magic-sparkles" href="/user-guide/editor/edit-with-ai-agent">
    Change the draft by chatting with the agent.
  </Card>

  <Card title="Publish and share" icon="share-nodes" href="/user-guide/share/publish-and-share">
    Publish the form and send it out.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.