> ## 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.

# The survey list

> Find, filter and organize your surveys on the Surveys page: statuses, search, folders, Organize with AI, the survey menu, bulk actions, archiving and deleting.

To see your surveys, select **Surveys** in the sidebar. The page lists every survey you have access to, with its status, channel and recent responses.

## Survey statuses

Each survey has one of these statuses:

* **Draft** surveys are still being built, and Usertick never shows them to anyone.
* A **Live** survey runs on its channel and collects responses.
* When a survey is **Paused**, it stops showing right away. Its responses are kept, and **Set live** resumes it.
* An **Archived** survey stops running, but its results stay readable. Archived surveys don't count toward the plan's survey limit.

When you edit a live survey, respondents keep seeing the published version until you publish your changes. A survey with unpublished edits shows an amber dot, between the survey's icon and its name on a card, and beside the **Last edit** date in the list. Hovering over the dot shows who made the edits.

If your organization moves to a plan that allows fewer surveys than it has, the extra live surveys pause and show **Paused because of the plan limit.** Each of them goes live again once your organization is under its survey limit. See [Plans and billing](https://docs.usertick.com/account/billing.md#items-over-the-limits-of-a-lower-plan).

## Find a survey

* **Status views** at the top of the left panel (**All surveys**, **Live**, **Paused**, **Drafts** and **Archived**) each show their count, and **All surveys** leaves archived surveys out.
* **Search** finds a survey when you type part of its name and press <kbd>Enter</kbd>, and the **?** beside the box lists the search syntax.
* **Filters** narrow the list by **Site**, **Folder** and **Status**.
* **Sort** orders the list by **Recently updated**, **Newest created**, **By name**, **Channel**, **Site**, **Questions**, **Responses**, **Last response** or **Status**.
* The **View** toggle beside **Sort** switches between cards and a list with columns.

| Search term | Finds |
| - | - |
| `is:live` | Surveys with a status: `live`, `paused`, `draft` or `archived` |
| `folder:"Onboarding flow"` | Surveys in a folder. Put quotes around a name with spaces. |
| `site:example.com` | Website surveys that run on one site |
| `churn` | Surveys whose name contains the text |

The line under the page heading counts the responses of the last 7 days across your live surveys, and **Most answered in the last 7 days** in the left panel opens the responses of your busiest surveys. On a plan with a survey limit, the bottom of the panel shows how many surveys are in use, such as "2 of 3 surveys".

## Act on a survey

Selecting a survey opens it in the editor, or opens its results if your role can't edit surveys. The **⋯** menu on each row holds the other actions and shows only the ones that apply to the survey's status and your role.

![The survey list in list view with the menu of a live survey open: Edit, View results, Workflows, Pause, Share, Duplicate, Move to folder, Access, Archive and Delete](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-row-menu.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=f27281c54e709d6f3d83c27126632375)

The survey menu

* **Edit** opens the survey in the [editor](https://docs.usertick.com/surveys/editor.md).
* **View results** takes you to the survey's [Results](https://docs.usertick.com/results/overview.md).
* **Workflows** lists the survey's [workflows](https://docs.usertick.com/workflows/overview.md) and appears for live and paused surveys.
* **Publish** opens a draft in the editor, where you publish it.
* **Pause** stops a live survey, and **Set live** resumes a paused one. If the survey has unpublished edits, **Set live** asks first, because it resumes the published version.
* **Restore** brings an archived survey back as a draft, except while your organization is at its survey limit.
* **Send survey** sends an email survey, and **View sends** lists its sends. See [Email surveys](https://docs.usertick.com/email.md).
* **Share** shows the link and QR code of a link or email survey. See [Link surveys](https://docs.usertick.com/channels/link.md).
* **Duplicate** creates a draft copy of the survey, named after it with "copy" added.
* With **Move to folder**, you can file the survey in a folder or remove it from its folder. To file it in a new folder, type the folder's name and select **Create folder**.
* **Access** lets you choose which roles with selected surveys can open the survey. See [Survey access](https://docs.usertick.com/workspace/members-and-roles.md#survey-access).
* **Archive** stops the survey and keeps its results.
* **Delete** removes the survey and its responses. See [Delete a survey](#delete-a-survey).

## Organize surveys in folders

Folders group your surveys in the left panel, and each survey can be in one folder at most. Selecting a folder shows only its surveys, and a survey you create while a folder is open is filed in that folder.

1. Under **Folders**, select **+**, the **Create folder** button.
2. Enter a **Name**, then choose an **Icon** and a **Color**.
3. Select **Create folder**.

To file a survey, use **Move to folder** in its menu. To rename a folder or change its look, open the folder's menu and select **Edit folder**. **Delete folder** removes only the folder, and its surveys go back to **All surveys**.

### Organize with AI

**Organize** beside **Folders** opens **Organize with AI**, which proposes a folder plan for your surveys. It asks which surveys to cover (**Not in a folder yet**, **All surveys** or **Select surveys**), how to group them (such as **Topic**, **Customer journey**, **Survey type** or **Channel**), how detailed the folders should be, the language of new folder names, how many folders to use and whether it can suggest new folders.

Before you select **Apply plan**, you can rename new folders, move a survey to another folder in the plan or leave a survey out. You can also ask for changes in the message box, and no survey moves until you apply the plan.

![The Organize with AI dialog with a plan ready to review: two new folders with their surveys, Suggest again, Apply plan and the box to ask for a change](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/surveys-organize-ai.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=0110910efb79ad53abfec8feb0f84345)

Organize with AI

Organize with AI is available on Starter and higher plans and draws on your organization's [AI credits](https://docs.usertick.com/account/billing.md#ai-credits).

## Change several surveys at once

Select the checkbox on each survey you want to change, or select **Select all**, and the bar above the list offers these actions:

* **Move to folder** files the selected surveys in an existing folder, or in a new one when you type its name and select **Create folder**.
* **Remove from this folder** appears while a folder is open.
* **Archive** archives the selected surveys.
* **Delete** deletes them once you confirm by typing the number of surveys, such as "3 surveys". When you selected one survey, the dialog names it and you type its name instead, as you would from its own menu.

Bulk actions are available on a computer or a tablet.

## Delete a survey

If you want to retire a survey and keep its results, archive it instead. **Delete** removes the survey, its email sends (scheduled ones included) and its responses along with their files, notes and AI readings. You can't undo a deletion, and the deleted responses still count toward the month in which they were submitted.

Before you confirm, the dialog shows what else the deletion affects. It names the workflows and scheduled reports that pause, the webhooks and API or Zapier subscriptions that stop sending the survey's events, and any other survey whose **Earlier surveys** rule names this one. You can't publish those surveys again until you remove the rule.

## On a phone

On a screen narrower than 768 pixels, the list stays readable, and selecting a survey opens its results. Creating and editing surveys requires a computer or a tablet.

## Who can do this

Every member with **View surveys and results** sees the list, and a role limited to selected surveys sees only those surveys. Creating, editing, changing a status, filing, archiving and deleting require **Manage surveys**. **Workflows** requires **Manage workflows**, and **Access** requires **Manage members** and the Business plan.

| Plan | Free | Starter | Pro | Business |
| - | - | - | - | - |
| Surveys (archived ones don't count) | 3 | 10 | Unlimited | Unlimited |
| Organize with AI | Not included | Included | Included | Included |


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