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

# NPS Settings

> Configure NPS targeting, triggers, frequency, and localization in Userpilot to collect feedback from the right users at the right time.

## Overview

Net Promoter Score (NPS) surveys help measure customer loyalty by asking users how likely they are to recommend your product. Userpilot provides flexible settings to target, trigger, and localize NPS surveys based on user behavior and preferences.

## Targeting an NPS

<img src="https://mintcdn.com/userpilot/x9xXqXi1_IGle4ai/mobilenps.png?fit=max&auto=format&n=x9xXqXi1_IGle4ai&q=85&s=8a6cbab2864e767dfa322ecd5f2499de" alt="" width="5760" height="6500" data-path="mobilenps.png" />

### **To control where and to whom the NPS survey appears**

1. Navigate to the **Settings** tab. Configure the following:

* **Platform**
  1. **Web app:** Select this option to target feedback collection specifically for your web app users.
  2. **Mobile app:** Select this option to target feedback collection specifically for your mobile app users.
* **Environment**
  1. **Production:** Triggers NPS in the live environment.
  2. **Staging:** Enables testing before deploying to production.
* **Domain targeting**
  1. **All Domains (Default):** Displays NPS on any site with Userpilot installed.
  2. **Specific Domains:**
     * **Matches:** Exact domain match.
     * **Doesn’t Match:** Exclude certain domains.
     * **Matches Regex:** Use wildcards (\*) for dynamic domains.
* **Page targeting**
  1. **Any Page (Default):** NPS survey appears across all pages.
  2. **Specific Pages:** Show NPS only on selected pages.
  3. **Specific URL Paths:** Target NPS based on URL structure.
* **Audience Targeting:**
  1. **All Users (Default):** Any identified user can see the survey.
  2. **Only Me:** Limits the NPS to your Userpilot account for testing.
  3. **Saved Segment:** Use pre-configured user segments.
  4. **Custom Conditions:** Define rules based on user attributes, company data, or product usage.

### Triggering an NPS Survey

#### Sampling Rate

Control how often users see the NPS survey:

* **100% Sampling:** Every eligible user sees the survey.
* **Lower Percentages:** Reduces daily exposure for selective sampling.

<img src="https://mintcdn.com/userpilot/eKuoNPh2qVInx2ej/images/Screenshot2025-07-10at10.15.39.png?fit=max&auto=format&n=eKuoNPh2qVInx2ej&q=85&s=fe7890857d4b692d001a7b58d7b51b54" alt="Screenshot2025 07 10at10 15 39 Pn" width="1528" height="738" data-path="images/Screenshot2025-07-10at10.15.39.png" />

#### Behavioral triggers

Trigger NPS based on user activity:

* **Number of Page Visits** before showing the survey.
* **Time Spent on a Page** before triggering the survey.

<img src="https://mintcdn.com/userpilot/eKuoNPh2qVInx2ej/images/Screenshot2025-07-10at10.16.27.png?fit=max&auto=format&n=eKuoNPh2qVInx2ej&q=85&s=6c9bf997e5496102d399724ccc0082f7" alt="Screenshot2025 07 10at10 16 27 Pn" width="1562" height="712" data-path="images/Screenshot2025-07-10at10.16.27.png" />

#### Frequency settings

Adjust how often users encounter the NPS survey:

* **Completed Users:** Defaults to 90 days before reappearing (best practice: 60-90 days).
* **"Ask Me Later" Clickers:** Defaults to 7 days (best practice: 3-7 days).

<img src="https://mintcdn.com/userpilot/eKuoNPh2qVInx2ej/images/Screenshot2025-07-10at10.17.08.png?fit=max&auto=format&n=eKuoNPh2qVInx2ej&q=85&s=34625fb63d06ba164c2db4ba79d4dd4a" alt="Screenshot2025 07 10at10 17 08 Pn" width="1548" height="708" data-path="images/Screenshot2025-07-10at10.17.08.png" />

## Localizing NPS content

<img src="https://mintcdn.com/userpilot/i_hL61WZW7vm9Xm1/DESKTOPLocaization.png?fit=max&auto=format&n=i_hL61WZW7vm9Xm1&q=85&s=bdc0ba49f4ee1e4be9535a5aa84ddf02" alt="" width="5760" height="4096" data-path="DESKTOPLocaization.png" />

**Setting Up Localization**

To accurately localize your NPS content, Userpilot uses a localization parameter:

* If you are passing user properties, use the **locale\_code** property following the ISO 639-1 standard.
* If no property is passed, Userpilot defaults to **Browser\_Language** to detect the user’s browser setting.

## Localization Methods

<Warning>
  Switching between Automated and Manual translation will reset any previous translations
</Warning>

### Automated Translation:

<img src="https://mintcdn.com/userpilot/i_hL61WZW7vm9Xm1/Group1000006486.png?fit=max&auto=format&n=i_hL61WZW7vm9Xm1&q=85&s=9817e5aa0fb4ebddfe283587f3623d4e" alt="" width="3680" height="2048" data-path="Group1000006486.png" />

1. Ensure locales are added in the **Localization** tab.
2. Select the desired language and click **Auto-Translate**.
3. Edit translations manually if needed.
4. Toggle **Live** to activate the translation.
5. Click **Publish** or **Publish Updates**.

### **Manual Translation:**

<img src="https://mintcdn.com/userpilot/za7GQhSM8Uw-ZL3_/tes5.png?fit=max&auto=format&n=za7GQhSM8Uw-ZL3_&q=85&s=2ced7617782e640756472afe33a462a6" alt="" width="3680" height="2048" data-path="tes5.png" />

1. Fully build your content before enabling manual localization.
2. Export the translation file in CSV or XLIFF format.
3. Enter translations into the **Target** column.
4. Save the file as **CSV UTF-8 (Comma delimited)**.
5. Import the translated file back into Userpilot.
6. Toggle **Live** to activate the translation.
7. Click **Publish** or **Publish Updates**.

   <img src="https://mintcdn.com/userpilot/4bTZyxkEsWzJ39h7/download(1).png?fit=max&auto=format&n=4bTZyxkEsWzJ39h7&q=85&s=8f0d805675ba1ff72d4a3605e2867a89" alt="" width="1116" height="658" data-path="download(1).png" />

## Previewing and publishing

1. Click **Preview** to test how the NPS looks.
2. Adjust any final settings.
3. Click **Publish** to deploy the NPS survey.

## FAQs

<AccordionGroup>
  <Accordion title="How often should I show NPS surveys to users?" defaultOpen="false">
    The best practice is every 60-90 days for completed users and 3-7 days for those who clicked "Ask Me Later."
  </Accordion>

  <Accordion title="What happens if I change the translation method from Automated to Manual?" defaultOpen="false">
    The translated content cannot be retrieved after switching methods.
  </Accordion>

  <Accordion title="What’s the difference between a green dot and a yellow dot in the Localization tab?" defaultOpen="false">
    * A **green dot** means the translated survey is **live and fully active** for end users.
    * A **yellow dot** means the translation is **saved but not yet live**, requiring publishing to take effect.
  </Accordion>
</AccordionGroup>

<Frame>
  For any questions or concerns please reach out to [**support@userpilot.com**](mailto:support@userpilot.com)
</Frame>
