# Create an NPS survey

> Set up a Net Promoter Score survey under Data Platform › NPS, choose its question, colours and triggers, activate it so the Releva SDK shows it on your site, and read the score in Analytics.

An **NPS survey** asks one question, “How likely are you to recommend us?”, on a 0-10 scale. Releva shows it as an overlay on your site or in your app through the Releva SDK, with an optional follow-up question per score group, and turns the answers into a Net Promoter Score. This guide creates an NPS survey, activates it and shows where the results are. For how a visitor is picked and how often the survey repeats, read [How surveys and NPS work](https://releva.ai/documentation/learn/surveys/how-surveys-and-nps-work/#how-an-nps-survey-reaches-a-visitor).

## Before you start

* The Releva JavaScript snippet (or a mobile SDK) runs on your site. The NPS overlay is part of it; nothing else needs installing. See [How Releva connects to your shop](https://releva.ai/documentation/learn/shop-settings/how-releva-connects-to-your-shop/).
* You know when the survey should appear: on which pages, after how many sessions, or after an event your site reports.
* NPS survey names must be unique within the store.

## Steps

1. Go to **Data Platform › NPS**.

   A store without NPS surveys shows **No NPS surveys yet** and a single **New NPS Survey** button. Otherwise the list shows every survey with its status, its **NPS Score** for the selected period (the last 30 days by default) and an **Analytics** button.

   ![Step 1](https://releva.ai/documentation/_astro/step-1.CuIdf-43_1duMzy.webp)

2. Select **New NPS Survey**.

   ![Step 2](https://releva.ai/documentation/_astro/step-2.BOwauZ9x_ZiUYEg.webp)

3. Enter a **Survey name**. It must be unique for the store.

   Visitors never see the name.

   ![Step 3](https://releva.ai/documentation/_astro/step-3.B__6E3ci_Z23c7uY.webp)

4. Open **Status** and choose **Active** when the survey should start showing. **Draft** and **Inactive** keep it hidden.

   You can save as **Draft** now and switch to **Active** later. Only active surveys are offered to visitors.

   ![Step 4](https://releva.ai/documentation/_astro/step-4.DstLbua1_Z1dlFdK.webp)

5. On the **Content** tab, edit the **Question**. Below it you can change the scale labels, the follow-up question and thank-you message for each group, and the button labels.

   The groups are **Promoters (9–10)**, **Passives (7–8)** and **Detractors (0–6)**. Each has its own follow-up question and thank-you message, so you can ask promoters what they love and detractors what to fix. Switch on **Follow-up comment is required** to keep the **Submit** button disabled until the visitor types a comment. Leave **Skip button (leave empty to hide)** empty to remove the skip button.

   ![Step 5](https://releva.ai/documentation/_astro/step-5.Bn_QFVoT_8XNUd.webp)

6. On the **Appearance** tab, set the colours, the **Button style**, the **Position** (**Bottom Sheet** or **Modal**) and an optional logo.

   **Primary color**, **Background color** and **Text color** take hex values; type one or pick it in the colour picker that opens under the field. **Button style** is **Pill**, **Rounded** or **Square**. **Logo URL (optional)** must start with `https://`. **Enable dark mode colors** adds a second set of colours for visitors in dark mode.

   ![Step 6](https://releva.ai/documentation/_astro/step-6.rpdBzYF-_1Ajs4v.webp)

7. On the **Triggers** tab, choose when the survey shows: the triggers, the **Trigger delay (seconds)**, the **Show policy** and the **Cooldown days**. Use the **Targeting** tab to limit dates, platforms and app versions.

   A new survey has one **Screen / Page View** trigger for all screens, a delay of 2 seconds, show policy **Until Answered** and a cooldown of 90 days. **Trigger type** can also be **Custom Event** (an event name your site reports with `Releva.trackEvent`) or **Session Count** (**Min sessions**). The survey shows when any trigger fires. **Cancel on events** hides a pending survey when one of the selected events happens first.

   ![Step 7](https://releva.ai/documentation/_astro/step-7.CwRM4KFx_2bhnzq.webp)

8. Select **Save**.

   ![Step 8](https://releva.ai/documentation/_astro/step-8.BZroIDg2_MWG1v.webp)

9. The survey appears in the list with its status. It shows “No responses yet” until the first answer arrives.

   ![Step 9](https://releva.ai/documentation/_astro/step-9.CIcekiQU_2m7Ly6.webp)

10. To see the results, select **Analytics** on a survey’s card. **NPS Score** is the share of promoters (9–10) minus the share of detractors (0–6), for the period selected at the top (the last 30 days by default). Below it are the score over time, the score distribution and the written responses.

    The screenshot shows the analytics of another survey that already has answers. **Score over time** switches between **Weekly** and **Monthly**. **Responses** lists every answer with its **Score**, **Comment** and **Date**, filtered by **All**, **Promoters**, **Passives** or **Detractors**, 50 per page.

    ![Step 10](https://releva.ai/documentation/_astro/step-10.CRflSoWg_Z2qCrW4.webp)

## Check it worked

* The new survey is on the **NPS Surveys** list with an **ACTIVE** badge and “No responses yet”.
* Open your shop in a fresh private browser window and wait for the trigger delay: the overlay appears at the bottom of the page (**Bottom Sheet**) or in the middle (**Modal**) with your question and the 0-10 scale. A visitor who already answered does not see it again, so use a window without Releva cookies.
* After the first answer, the card shows an **NPS Score** and **Analytics** lists the response. With one answer the score is +100, 0 or -100; it becomes meaningful with more answers.

## Troubleshooting

**“Survey name is required.”** The name is empty. **Save** needs a name.

**“NPS Survey name must be unique!”** Another NPS survey in this store has the same name. Change it and save again.

**“URL must start with https\://”** The **Logo URL (optional)** is not an HTTPS address. The form switches to the **Appearance** tab to show the field. Clear it or enter a full `https://` URL.

**“End date must be after start date.”** On the **Targeting** tab the **End date** is on or before the **Start date**. Clear the end date or move it later.

**The survey does not show on my site.** Check, in this order: **Status** is **Active**; today is between the **Start date** and **End date**; the page you are on matches **Limit to screens**; you have not answered this survey before (**Until Answered** and **Once Ever** hide it for anyone who answered, and every policy waits out the **Cooldown days** after an answer); the survey was not already shown in this browser session (one survey per session); if **Platforms** are ticked, **Web** is among them. Releva shows the first active survey that passes all checks, so an older active survey can take the slot. To preview a draft or an already-answered survey, open your shop with `?rlv_mode=debug` in the address: debug mode ignores status, dates and frequency but keeps the targeting rules.

**Two surveys are active and the wrong one shows.** Releva offers one NPS survey per page view, the oldest active survey that passes its checks. Set the other survey to **Inactive**, or narrow its **Targeting** and **Triggers**.

**“No responses in this period.”** The **Analytics** date range has no answers. Widen the range at the top of the page; it defaults to the last 30 days.

**“Not found”** The survey in the link was deleted or belongs to another store. Go back to **Data Platform › NPS** and open it from the list.

## Next steps

* [How surveys and NPS work](https://releva.ai/documentation/learn/surveys/how-surveys-and-nps-work/): Learn how Releva picks an NPS survey for a visitor, how often it repeats and where answers go.
* [Create a survey](https://releva.ai/documentation/guides/surveys/create-a-survey/): Build a survey with several questions and share it by link or QR code.
* [Create a segment](https://releva.ai/documentation/guides/segments/create-a-segment/): Group customers by their NPS answer so you can follow up with promoters or detractors.
* [Surveys and NPS API](https://releva.ai/documentation/reference/surveys/overview/): Show the NPS survey in your own widget or app with the public endpoints.