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

# Setup Guide

> Add the NPS survey widget to your Shopify thank you page

## Overview

After [installing the app](/installation), you need to add the NPS survey widget to your thank you page. This is a one-time setup that takes about 2 minutes.

<Info>
  The survey appears **only on the order confirmation page** after customers complete their purchase.
</Info>

## Adding the Survey to Your Thank You Page

<Steps>
  <Step title="Open Checkout Settings">
    In your Shopify admin, navigate to: **Settings** → **Checkout** → Click the **Customize** button

    <Tip>
      You can also access this directly from the app dashboard by clicking "Open Checkout Settings"
    </Tip>
  </Step>

  <Step title="Access Apps Panel">
    In the checkout editor:

    1. Click the **Apps** icon (puzzle piece) in the left sidebar
    2. This opens the panel showing available checkout extensions
  </Step>

  <Step title="Add Simple NPS Survey">
    1. Find **Simple NPS Survey** in the apps list
    2. Click the **+** (plus) icon next to it
    3. Select **Thank you** from the dropdown menu
  </Step>

  <Step title="Position the Widget">
    The NPS widget will appear on the thank you page. You can drag it to reposition if needed.
  </Step>

  <Step title="Customize (Optional)">
    Click on the widget to customize:

    * Title text
    * Subtitle text (leaving subtitle blank will hide this element)
    * Show/hide comments textbox
    * Comments textbox label
    * Button text
    * Successful submission title
    * Successful submission subtitle
  </Step>

  <Step title="Save Changes">
    Click the **Save** button in the top right to publish your changes
  </Step>
</Steps>

<Check>
  Your NPS survey is now live! Customers will see it after completing their purchase.
</Check>

## Testing Your Setup

To verify the survey is working correctly:

<Steps>
  <Step title="Place a Test Order">
    Create a test order in your store.
  </Step>

  <Step title="Complete Checkout">
    Go through the entire checkout process
  </Step>

  <Step title="Check Thank You Page">
    After completing the order, you should see the NPS survey widget on the thank you page
  </Step>

  <Step title="Submit a Test Rating">
    Submit a test rating and check if it appears in your app dashboard
  </Step>
</Steps>

<Warning>
  Development stores and test mode orders work perfectly for testing. The survey will appear for all orders. For stores already setup with live payments then consider using a 100% off discount code or gift card and refunding the order after you've tested.
</Warning>

## Common Setup Issues

<AccordionGroup>
  <Accordion title="Can't find the app in checkout editor" icon="triangle-exclamation">
    **Solution:**

    * Ensure the app is fully installed from the App Store
    * Refresh the checkout editor page
    * Check that you have permission to modify checkout settings
  </Accordion>

  <Accordion title="Survey not appearing on thank you page" icon="eye-slash">
    **Solution:**

    * Check if you've exceeded the free plan monthly limit (120 ratings)
    * Verify you clicked "Save" in the checkout editor
    * Clear your browser cache and try a new test order
    * Ensure the widget is added to the "Thank you" page specifically (not other checkout pages)
  </Accordion>

  <Accordion title="Test ratings not showing in dashboard" icon="chart-line">
    **Solution:**

    * Wait 10-15 seconds and refresh the dashboard
    * Verify the order was completed successfully
    * Check if you've exceeded the free plan monthly limit (120 ratings)
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="View Dashboard" icon="chart-line" href="/features/nps-dashboard">
    Start collecting and analyzing customer feedback
  </Card>

  <Card title="Upgrade to Premium" icon="gem" href="/pricing/premium-plan">
    Unlock unlimited ratings and advanced features
  </Card>
</CardGroup>

## Need Help?

Can't get it working? We're here to help!

<Card title="Contact Support" icon="headset" href="/support/contact">
  Get help from our support team
</Card>