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

> ## Agent Instructions
> Usertick runs surveys on websites, by link, by QR code and by email, and collects every response in one inbox with reports, dashboards and workflows. The REST API lives at https://app.usertick.com/api/public/v1 and uses Bearer API keys or OAuth access tokens; the JavaScript SDK is the @usertick/snippet package on npm.

# Add and edit questions

> Add questions in the survey editor's Content tab, from the type picker, AI or the question library, and set media, time limits, page groups and AI wording help.

You write questions in the **Content** tab of the editor's **Survey** step. The list on the left shows the survey's questions in order, and selecting one opens it for editing.

## Add a question

1. Under the list, select **New question**.
2. In **Select a question type**, select a type under **Scale**, **Choice**, **Text** or **Custom**. Each type shows a sample. See [Question types](https://docs.usertick.com/surveys/question-types.md).
3. Write the question text in the form that opens.

To let AI write the question, type what you want to ask in **Describe a question and AI will write it** at the top of **Select a question type**, then select **Write it**. AI picks the type and sets it up to match: a matrix comes with its rows and columns, a scale with its range, end labels and unit, and a consent question with the words beside its box. It also avoids asking what the survey already asks, such as a second NPS question, and writes the new question to follow the last one in your survey.

![Select a question type with the Describe a question and AI will write it field and Write it at the top, the Scale group and the start of the Choice group](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-question-type-picker.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=570fff7faf9d77ac8ae7f98ee674af68)

Select a question type

## Add questions from the library

**From library** opens the **Question library** of ready-made questions, grouped by industry in the list on the left and by topic within each industry. You can search with **Search questions** and narrow the list by answer type with **Scores**, **Choices**, **Numbers**, **Open text** or **Details** at the top. Select one or more questions, then select **Add selected**, and you can edit each question after you add it.

The library is translated into the 14 [languages Usertick ships](https://docs.usertick.com/surveys/languages.md#available-languages), and in a language your organization added, it appears in English.

![The Question library with Search questions, the answer type chips, the industry list on the left, two questions selected and Add selected](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-question-library.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=b59190651e070dbf1da41901cab7a28f)

Question library

## Edit a question

Every question has these settings, followed by the settings of its type:

* **Question text** holds the question itself, and **Add introduction** adds a short text shown before it.
* **Add media** places an image or a video from the media library, which you can adjust with **Media position** (**Above question** or **Below question**), **Media size**, **Media alignment** and **Alt text** for screen readers.
* **Required** keeps the respondent from moving on without answering.
* **Time limit** gives the question a countdown, as described [below](#set-a-time-limit).
* **Branching by answer** holds the rules that send respondents to another question. See [Logic and branching](https://docs.usertick.com/surveys/logic.md).

The media library holds the images and videos your team uploads. **My uploads** shows your own files, and **Organization library** shows the files shared with everyone. **Upload media** accepts PNG, JPG, WebP or GIF images up to 10 MB and MP4 or WebM videos up to 200 MB, and every upload counts toward your plan's [media storage](https://docs.usertick.com/account/billing.md#media-storage).

## Arrange questions

* **Reorder** questions by dragging them in the list, or focus a question and use the up and down arrow keys.
* Each question's menu holds **Duplicate**, **Change question type** and **Delete**.

When you change the type, Usertick keeps the wording and the image and resets the settings of the old type, including its logic rules. On a survey that has been live, the retyped question is saved as a new question, so answers of the old and new type stay apart. When you delete a question, the answers it already collected stay with their responses.

## Put questions on one page

In the **Step by step** layout, each question has its own page by default. Hover between two questions in the list and select **Put on one page** to show them together, or **Split the page here** to separate them again. The list labels each group **Page 1**, **Page 2** and so on. In the **Chat** layout, each question always appears alone.

## Set a time limit

**Time limit** gives a question a countdown, which respondents see as a ring next to the close button. A timed question always shows on its own page.

* **Seconds** can be set from 5 to 600.
* Under **When time runs out**, **Next question** moves on, and **Send answers** submits the answers given so far.
* **Allow going back**, called **Allow changing the answer** in a chat survey, lets respondents return to the question while time remains.

Time limits work only in the **Step by step** or **Chat** layout and are available on Starter and higher plans. You set a time limit for the whole survey in the [Settings tab](https://docs.usertick.com/surveys/editor.md#survey-settings).

![A text question with Time limit on, Seconds set to 30, When time runs out with Next question and Send answers, and Allow going back off, with the 0:30 countdown beside the close button in the preview](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-question-time-limit.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=5f6e4b59402ebedb5efab4bef137e82e)

A question's time limit

## Improve the wording with AI

* **Suggest**, beside an empty question field, opens **AI suggestions** with questions written for the type and for what you already set on the question, such as its answer options, range and unit. Describe what you want to ask to steer them, then select one. While the question still has its starting options, rows or columns, the suggestion you select fills them in too.
* **Improve with AI**, **Neutralize with AI**, **Shorten with AI** and **Rewrite with AI** appear beside a field with text. The new wording still fits the question's answer options, rows, unit and range. Review the result, then select **Apply** or **Cancel**.
* On the Starter plan and above, the editor also checks the wording as you type and shows **This wording may steer the answer** under a question that could bias respondents.
* **Test as variant**, under a suggestion, creates a variant that shows the new wording to a share of respondents, so you can compare both wordings. See [Variants](https://docs.usertick.com/surveys/variants.md).

AI writes for the survey you are editing: it reads the survey's name and welcome screen, where and when the survey shows, the questions before and after the one you edit, and the answers that lead respondents to it. A question that only respondents with a low score reach is written for them, and AI doesn't add product names, plans or prices that your survey doesn't mention.

![The AI result under a question's text, with the reason for the change, the new wording, Cancel, Test as variant and Apply](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-ai-suggestions.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=2b340d4d756fabc27cbb365f9a6e5cb6)

An AI result under a question

AI suggestions are available on every plan and draw on your organization's [AI credits](https://docs.usertick.com/account/billing.md#ai-credits), while the checks the editor runs on its own use no credits.

## Plan limits

| Limit | Free | Starter | Pro | Business |
| - | - | - | - | - |
| Questions per survey (welcome and message screens don't count) | 10 | 100 | 200 | 200 |
| Questions that collect a file, screenshot or signature | 1 | Unlimited | Unlimited | Unlimited |
| Time limits | Not included | Included | Included | Included |
| Wording check while you type | Not included | Included | Included | Included |
| **Test as variant** | Not included | Not included | Not included | Included |

When a survey reaches the question limit, **From library** stops adding questions, **Select a question type** offers only message screens, and a line under the buttons explains why. When it reaches the file question limit, the picker locks the file, screenshot and signature types. On Free, a text question with **Allow screenshot** or **Allow file upload** turned on counts as the survey's file question.


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