NPS Settings
In the app: Settings → NPS
Needs the 'NPS Settings' permission.
NPS (Net Promoter Score) surveys ask customers who ordered how likely they are, from 0 to 10, to recommend the store. Unlike CSAT, which rates one support conversation, NPS is sent after an order, on a schedule you set. Everything on this page is set per store: each store you can access has its own card. The results are in Reports.
Store cards
Each store has a card. Click it to open its settings. Labels on the card show its state:
- "Enabled" or "Disabled": whether "Send NPS surveys for this store" is on in the card as it stands, including a change you have not saved yet.
- "Sending paused": Squid stopped sending for this store; see "Sending limit and paused sending".
- "No Shopify": the store is not connected to Shopify. NPS is based on orders, so new order-based surveys cannot be collected until Shopify is connected; inside the card, "Connect Shopify" opens Settings → Integrations.
- How the store's order reading is going: "Not started yet", "Reading new orders", "Backfill queued", "Loading order history" or "Not collecting orders". For states with progress information, hover to see the numbers of orders read and survey candidates created. A candidate can still fail the consent and other sending checks. Two problems are shown as a warning inside the card instead: "Waiting on Shopify approval", when Shopify has not given Squid access to customer email addresses, and "The last order sweep failed", after which Squid retries by itself.
- "Unsaved changes": the card has edits that are not saved yet.
"Send NPS surveys for this store" is off by default. When it is on, Squid queues a survey for each new order and sends it once the waiting time has passed. New orders are read from Shopify about once an hour. When it is off, scheduled surveys stop, but you can still send yourself a test; surveys that were waiting are kept and go out when you switch it on again, unless they have become too old (see "Sending limit and paused sending"). The first order sync also loads up to 60 days of recent history automatically. Eligible orders from before you turned surveys on can therefore be surveyed without using "Load past orders once".
If the page shows "Surveys are off in this environment", settings can be saved but nothing is read or sent.
Seeing and changing this page needs the 'NPS Settings' permission.
When to ask
"Start counting from" is the moment the waiting time starts:
- "Order placed": when the order is created. Always available and needs nothing from the carrier, but the customer may not have received anything yet when the survey arrives.
- "Order fulfilled (tracking added)": when Shopify records a fulfillment. Despite the label, Squid does not check whether a tracking number was added. That does not mean the parcel has shipped or arrived.
- "Order delivered": when delivery is confirmed by Parcel Panel or Shopify. This is the default. It never falls back to another date, so an order without a delivery confirmation is never surveyed. Without delivery data, orders may be collected but no delivery-based survey becomes due.
For the last two, Squid keeps checking the order for that moment until the order is 45 days old. An order that still has no tracking or no delivery confirmation by then is not surveyed.
"Wait before sending" is the number of days after that moment, from 0 to 365. The default is 14. Changing it reschedules orders whose starting date has already been found and whose survey has not been queued or skipped.
"Don't ask the same customer again for" is the number of days before the same customer can get another survey, from 0 to 3,650. The default is 180. It is counted per store, so a customer of two of your stores can be asked about each. If the cooldown is still active when Squid checks a due order for sending, that order is skipped for good, not postponed: the customer is asked again about a later order.
"Survey link stays open for" is how many days the link in the email works, from 1 to 365. The default is 30. After that the link shows a page saying the survey has closed, in the store's own styling.
Who may be asked
- "Only customers who accepted marketing email": Squid follows Shopify's email marketing consent, and checks it again at the moment the survey is sent, not when the order came in. This is the default.
- "Every customer who ordered": also reaches customers who never accepted marketing email. It can only be saved after you tick the acknowledgement that the store treats the survey as service mail and not marketing, and takes responsibility for that in every country it sells to. Your name and the time are recorded with the store, and the card shows when it was acknowledged.
The opt-out list. Each store has its own list of email addresses that never get a survey, whichever option is chosen. An address is added when:
- the customer uses the unsubscribe link in a survey email, or the unsubscribe button of their mail program;
- an email to that address bounces permanently, for example because the address does not exist;
- the customer reports an email as spam.
Apart from this list, a survey is also not sent to a customer without an email address, to an address where any email from you bounced permanently in the last 180 days, or to one of your own mailboxes or an address on a listed company domain.
A full mailbox or another temporary delivery problem does not add an address. The list is checked again at the moment each survey is sent. It only stops surveys: replies to the customer's tickets and other emails are still sent. A customer can undo their unsubscribe from the same unexpired link, provided that link was the sole source of the opt-out; an address added for a bounce or a spam report cannot be put back that way. The list is per store, so opting out of one store's surveys does not stop another store's. This page has no control to see or edit the list.
Survey questions
"Always asked" is the 0 to 10 question. It can be reworded, but not moved or removed. Leave the field blank to ask the standard question, "How likely are you to recommend" the store "to a friend or colleague?", in all seven languages. A question you type is sent exactly as written, in one language, and the store's name is not filled in for you. Squid warns under the field in three cases: your wording no longer asks about recommending, so the score is still calculated the same way but can no longer be compared with published NPS benchmarks; your wording contains the store-name placeholder, which would be sent literally; or your wording matches a recognised alternative scale. The check does not recognise every possible scale wording. The warnings do not stop you from saving.
"Comment prompt" is the line under the scale that invites a comment. Blank uses the translated default.
"Follow-up questions" are extra questions after the score. "Add question" adds one, up to 5. Drag a question to reorder it. Each has a label of up to 200 characters and a type:
- "Free text": the customer types an answer.
- "Rating scale": a scale between two numbers you set, at most 10 points wide.
- "Multiple choice": 2 to 10 answer options.
- "Yes / No".
Without follow-up questions, customers answer the 0 to 10 question and can add a comment.
Each follow-up question also has a "Required" tick box: the survey page asks the customer to answer a required question before they can submit.
"Note for this change (optional)", up to 500 characters, is shown beside the version in the history. "Previous versions" lists every version of the survey with its number, "In use" on the current one, how many responses it collected, how many follow-up questions it has, since when it was in use and its note. Next to the heading, the card shows the current version number, since when it is in use and its number of responses.
The invitation email
Leave "Subject" and "Body" empty to send the standard invitation, which is translated into all seven languages: English, German, Swedish, Norwegian, Danish, Finnish and French. Anything you type replaces it for every customer, whatever language they read, and is sent as plain text: formatting or code you type is shown as text, not applied. The subject can be up to 1,000 characters and the body up to 20,000. In either field, {brand} is replaced with the store name. The survey button and unsubscribe footer are still included.
A customer gets the survey in the language Shopify has for them or for their order when it is one of the seven, otherwise in the store's language, otherwise in English.
Sending limit and paused sending
"Send at most" is the largest number of surveys this store sends per hour, from 1 to 100,000. The default is 200. On the card it sits under "The invitation email". Scheduled surveys are limited over the previous 60 minutes and the previous 24 hours; the daily ceiling is 24 times the hourly limit. Queued mail counts towards these limits, including tests and mail that later fails; cancelled mail does not. Test sends themselves bypass the limits. Surveys that do not fit wait until capacity becomes available. A survey still waiting more than 60 days after it became due expires; other eligibility checks can skip it sooner. Survey mail goes out from the same domain that answers your tickets, so it protects that domain's reputation.
Automatic pause. Squid stops sending for a store when too many of its surveys bounce or are reported as spam. It looks at the store's surveys sent in the last 24 hours, and only once at least 200 were sent in that time:
- more than 5% of them bounced permanently, or
- more than 0.1% of them were reported as spam (more than 1 in 1,000).
The card then shows the label "Sending paused" and a panel "Survey sending is paused" with the reason: too many survey emails bounced, or too many recipients marked the survey as spam. While paused no new survey is queued for that store, including tests; mail already queued can still be delivered; surveys that were waiting stay waiting, for up to 60 days after they became due. Other stores keep sending. Settings can still be changed while paused.
A pause never ends by itself, also not when the bounces are more than 24 hours old. Somebody has to resume it.
"Resume sending" starts sending again. You must type why, in "Why sending is being resumed", between 3 and 200 characters; the reason is recorded. For a store whose initial or requested historical load has started, resuming starts the slow start described there again at its first day.
"Score shows from … answers": a score is published for a store once it has the number of responses shown there. Below it, reports show how many answers came in and how they split between promoters, passives and detractors, but no score.
Send yourself a test
Enter an email address under "Send to", optionally choose a "Language" ("Store default" uses the store's language), and click "Send test survey". The test uses the saved survey and the saved email text, so save the card first; with unsaved edits the button is disabled and a note tells you to save.
A test is marked as a test. Its answer is left out of every score and report, so you can complete it. It does not get around the opt-out list or a paused store: for an address on the store's opt-out list, or while the store is paused, no test is sent and the page says why. A test is sent from the store's verified sending address; a store without one cannot send a test until an address is set up under Settings → Email. The test is not available while the page shows "Surveys are off in this environment".
Load past orders once
"Load past orders once" requests another historical order sync. The first sync after enabling surveys already loads recent history automatically. You can request another load after the previous requested load finishes; orders already surveyed are not surveyed again.
Enter "Days of history", from 1 to 60 days (the field starts at 60), and click "Start backfill". Both are disabled for a store without Shopify. Squid asks you to confirm: every eligible past customer it finds is sent a survey, within the hourly limit and the opt-out list. The load queues eligible surveys for gradual sending; it does not send all mail immediately. After it starts, a note says how many days back it reaches; when Shopify does not let Squid read that far back, the note gives the accepted number of days. However, the sync currently uses its configured history window, normally 60 days, even if you request fewer days. The note does not prove that only the requested period was read.
Slow start. For the first six days after an automatic or requested historical load starts, the store's surveys are also limited per day, so the email domain is not flooded:
- day 1: at most 50 surveys;
- day 2: 100;
- day 3: 250;
- day 4: 500;
- day 5: 1,000;
- day 6: 2,000.
From day 7 only the hourly limit under "Send at most" applies. Each stage lasts 24 hours from the load starting or sending being resumed. The daily limit counts mail queued during the previous 24 hours, including tests, and the hourly limit still applies on top. When sending is paused and resumed, also later on, the slow start begins again at 50 a day. A large backfill therefore takes several days to send; surveys wait their turn.
Saving and versions
"Save settings" saves one store, and is available once the card has a change. Nothing on a card is saved before that, except "Resume sending", a test and a backfill, which act at once. Leaving the page with unsaved changes asks you to confirm.
Changing the survey questions publishes a new version, and Squid asks "Publish this as a new version of the survey?" first. That covers the wording of the 0 to 10 question, the comment prompt, and each follow-up question's label, type, answer options, scale, "Required" tick and position. Surveys that were already sent keep the version they were sent with, and answers already collected keep the wording those customers saw. Existing results are never rewritten. A save that changes none of these does not create a version: the other settings on the card, including the invitation email's subject and body, are not versioned, and a changed note alone is stored on the version in use.
If only part of a save goes through, the card says what was saved and what was not. Your edits stay in the card; click "Save settings" again to finish.