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

<Steps>
  <Step title="Create your survey ">
    Start with a template or build a survey from scratch.
  </Step>

  <Step title="Add questions ">
    Choose from 15+ question types and customize each question.
  </Step>

  <Step title="Customize your Thank You Page">
    Create a personalized post-submission experience.
  </Step>

  <Step title="Style your survey">
    Adjust colors, fonts, themes, and overall survey appearance.
  </Step>

  <Step title="Publish your survey">
    Choose the publishing method that works best for your store.
  </Step>
</Steps>

## Detailed Guide: Create Your First Survey

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/create-new-survey-button.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=0f3051b7c17485da8a888640761ef3f4" alt="Create New Survey Button" width="1774" height="976" data-path="images/create-new-survey-button.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-template-popup.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=307234496fda1462efa307ff7e0ae5d7" alt="Survey Template Popup" width="2082" height="1100" data-path="images/survey-template-popup.png" />
    </Frame>

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

    <Info>
      The survey name is for **internal use only** and will not be visible to customers.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/name-your-survey-popup.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=97ad10d7fe0dd5da000bc1f04609e6cc" alt="Name Your Survey Popup" width="1014" height="414" data-path="images/name-your-survey-popup.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-dashboard.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=0c30e0f8d6974922198451aa87f7a4cc" alt="Survey Dashboard" width="2836" height="1218" data-path="images/survey-dashboard.png" />
    </Frame>

    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.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/question-types-popup.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=c8dba6502a6c783ae5e09cc06db0457e" alt="Question Types Popup" width="1346" height="1116" data-path="images/question-types-popup.png" />
    </Frame>

    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.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/pages-structure-survey.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=f901a1fd6dabeb73b5f9d544ef2d2776" alt="Pages Structure Survey" width="1968" height="852" data-path="images/pages-structure-survey.png" />
    </Frame>

    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.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/add-button-for-page.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=7cccf743118d7b2af5d9ed067f13494b" alt="Add Button For Page" width="2028" height="1174" data-path="images/add-button-for-page.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/star-rating-question-settings.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=3a359536b58e1be2f518f3544f6d1a1c" alt="Star Rating Question Settings" width="2074" height="1084" data-path="images/star-rating-question-settings.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/thank-you-page-block.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=4b6be01c9e9be64b94d3db1f77c4ad13" alt="Thank You Page Block" width="2850" height="1040" data-path="images/thank-you-page-block.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/shopify-survey-themes.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=303199cc1ce77e23975b773b121414b5" alt="Shopify Survey Themes" width="2828" height="1082" data-path="images/shopify-survey-themes.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-integration.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=e83ef3731934ef7d81de8faec7f33b33" alt="Survey Integration" width="2822" height="1220" data-path="images/survey-integration.png" />
    </Frame>
  </Step>

  <Step title=" Step 7: Publish your survey">
    Once your survey is ready, choose how you want to display it on your store.

    <Frame>
      <img src="https://mintcdn.com/apricot-survey/j_rIWlobp1yr8cT1/images/survey-publish-types.png?fit=max&auto=format&n=j_rIWlobp1yr8cT1&q=85&s=80bc46b1390dfd93dd833df2da37a1bd" alt="Survey Publish Types" width="2830" height="1208" data-path="images/survey-publish-types.png" />
    </Frame>

    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.
  </Step>
</Steps>
