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

# Create Your First Survey

In this guide, you'll create your first survey, add a few questions, and prepare it for publishing.

By the end of this tutorial, you'll have a fully functional survey ready to share with your customers.

## Quick Start: Create Your First Survey in 5 Simple Steps

Create your first survey with Apricot by following a simple workflow:

\*\*1. Create your survey \*\*

Start with a template or build a survey from scratch.

\*\*2. Add questions \*\*

Choose from 15+ question types and customize each question.

**3. Customize your Thank You Page**

Create a personalized post-submission experience.

**4. Style your survey**

Adjust colors, fonts, themes, and overall survey appearance.

**5. Publish your survey**

Choose the publishing method that works best for your store.

## Detailed Guide: Create Your First Survey

**1. Step 1: Open the survey builder**

From the Apricot Dashboard, go to **Surveys** and click **Create Survey.**

You can start creating a survey in two ways:

* Click the **Create Survey** button located in the top-right corner
* Click the **Create your first survey** button in the middle of the screen

Both options will open the same survey creation flow.

![Create New Survey Button](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/create-new-survey-button.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=0f3051b7c17485da8a888640761ef3f4)

**2. Step 2: Choose how to start building your survey**

On the **Start building your survey** screen, you can choose between:

* **Use a template** — Start with a pre-built survey
* **Blank Survey** — Create a survey from scratch

![Survey Template Popup](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-template-popup.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=307234496fda1462efa307ff7e0ae5d7)

### Using a template

When you select a template, Apricot will automatically import the template content into your survey, including:

* Survey questions
* Survey title based on the selected template
* Branching logic (if available)

You can edit and customize all imported content after creating the survey.

### Creating a blank survey

If you select **Blank Survey**, a popup will appear asking you to name your survey.

Enter your survey title in the **Name your survey** field.

> [!NOTE]
>
> The survey name is for **internal use only** and will not be visible to customers.

![Name Your Survey Popup](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/name-your-survey-popup.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=97ad10d7fe0dd5da000bc1f04609e6cc)

**3. Step 3: Add questions to your survey**

After creating your survey, you will be redirected to the survey editor.

The builder is divided into four main areas:

* **Left panel** — Survey structure and page navigation
* **Center panel** — Live survey preview
* **Right panel** — Question and survey settings
* **Top navigation bar** — Access different survey sections

![Survey Dashboard](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-dashboard.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=0c30e0f8d6974922198451aa87f7a4cc)

To add a question, click **Add New Question** from the left panel.

Apricot supports **15+ question types,** allowing you to create different types of surveys based on your needs.

![Question Types Popup](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/question-types-popup.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=c8dba6502a6c783ae5e09cc06db0457e)

When you add a new question, Apricot automatically **creates a new page** containing that question.

By default, **each question is placed on a separate page** and appears as an individual step in your survey.

![Pages Structure Survey](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/pages-structure-survey.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=f901a1fd6dabeb73b5f9d544ef2d2776)

If you want to **add** **multiple questions to the same page**, use the **Add** button inside an existing page.

This allows you to place multiple questions on a single survey page.

![Add Button For Page](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/add-button-for-page.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=7cccf743118d7b2af5d9ed067f13494b)

### Customize your questions

After selecting a question, use the right panel to configure its content and settings.

From the **Content** tab, you can customize:

* Question title
* Description (optional)
* Answer choices
* Placeholder text 
* Labels

From the **Settings** tab, you can configure additional options for each question, including:

* Change the question type
* Make the question required
* Configure question-specific settings (available options vary depending on the selected question type)
* Add a question image
* Add user explanation
* Set up branching logic

![Star Rating Question Settings](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/star-rating-question-settings.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=3a359536b58e1be2f518f3544f6d1a1c)

**4. Step 4: Customize your Thank You Page**

After adding your questions, customize the page customers see after completing your survey.

The Thank You Page uses a **block-based editor,** allowing you to create a personalized completion experience.

You can add blocks such as:

* Heading
* Text
* Button
* Image
* Custom HTML

![Thank You Page Block](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/thank-you-page-block.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=4b6be01c9e9be64b94d3db1f77c4ad13)

**5. Step 5: Style your survey**

Use the **Styles & Settings** section to customize the overall look and behavior of your survey. You can configure options like survey theme, colors, font families, general survey settings, etc.

![Shopify Survey Themes](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/shopify-survey-themes.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=303199cc1ce77e23975b773b121414b5)

**6. Step 6: Connect integrations**

If you want to send survey data to third-party tools, configure your integrations from the **Integrations** section.

Connect Apricot with supported apps to automate your workflow and sync collected responses.

![Survey Integration](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-integration.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=e83ef3731934ef7d81de8faec7f33b33)

**7.  Step 7: Publish your survey**

Once your survey is ready, choose how you want to display it on your store.

![Survey Publish Types](https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-publish-types.png?fit=max\&auto=format\&n=j_rIWlobp1yr8cT1\&q=85\&s=80bc46b1390dfd93dd833df2da37a1bd)

Apricot supports multiple publishing options, including:

* Public Link / Standalone Page
* On-site Surveys (Popup)
* Inline Block
* Thank You Page
* Exit Intent Popup

For detailed instructions, check the dedicated guide for each publishing method.


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