Customer Surveys

Customer Surveys is all in one powerfull WooCommerce plugin that adds post-purchase, email, and on-site surveys to WooCommerce. Answers stay in your WordPress database and can be tied to the order the customer placed, including the total in the currency that customer paid.

Use it for “How did you hear about us?”, checkout satisfaction (CSAT), Net Promoter Score (NPS) after delivery, cart exit questions, refund reasons, or a tablet at the counter.

Requirements:

  • WordPress 6.5+
  • WooCommerce 7.2+ (tested with WooCommerce 11.2)
  • PHP 7.4+
  • HPOS compatible
  • Cart and Checkout blocks compatible (surveys are not placed inside checkout)

Installation

↑ Back to top

To start using a product from WooCommerce.com, you can use the “Add to store” functionality on the order confirmation page or the My subscriptions section in your account.

  1. Navigate to My subscriptions.
  2. Find the Add to store button next to the product you’re planning to install.
  3. Follow the instructions on the screen, and the product will be automatically added to your store.

Alternative options and more information at:
Managing WooCommerce.com subscriptions.

Setup and Configuration

↑ Back to top

After install and activation, open WooCommerce → Customer Surveys. WooCommerce must already be active.

On a new store with no surveys yet, three surveys are created and set to Active:

  • How did you hear about us? (thank-you page)
  • Checkout satisfaction (thank-you page)
  • NPS after fulfillment (email after the order is completed)

Review those before you leave them on. Pause or delete any you do not want customers to see.

Where to work in admin

↑ Back to top
ScreenPathWhat you do there
SurveysWooCommerce → Customer Surveys → SurveysCreate, edit, pause, duplicate, or delete surveys
TemplatesWooCommerce → Customer Surveys → TemplatesStart from a ready-made survey
ResponsesWooCommerce → Customer Surveys → ResponsesRead individual answers and export CSV
SettingsWooCommerce → Customer Surveys → SettingsStore-wide email, brand, privacy, and event options
Activity LogWooCommerce → Customer Surveys → Activity LogSee survey saves and new responses
AnalyticsWooCommerce → Analytics → Customer SurveysTotals, charts, NPS, CSAT, revenue by answer

If WooCommerce Analytics is turned off, the summary and reports stay under WooCommerce → Customer Surveys instead of Analytics.

Shop managers and administrators can open these screens. The capability is stackwc_csfw_manage.

Create a survey

↑ Back to top
  1. Go to WooCommerce → Customer Surveys → Surveys.
  2. Click Add survey.
  3. Pick a template, or Start from scratch.
  4. Name the survey and choose where it appears.
  5. Add questions.
  6. Set display, targeting, and an optional coupon.
  7. Set the status to Active and save.

Statuses

↑ Back to top
StatusWhat customers see
DraftNothing. Use this while you are still editing.
ActiveThe survey can show, if placement and targeting match.
PausedHidden, but the survey and its answers stay saved.

Each saved survey shows a shortcode, for example [customer_survey id="12"], and a public link for email and share pages.

Purpose is used to group the survey in reports. The choices are Attribution (how they found you), NPS, CSAT, CES, Feedback, Product research, and Refund / cancellation.

Templates

↑ Back to top

Templates are starting points. After you click Use template, the new survey is a Draft. Change the questions, placement, and targeting, then set it to Active.

TemplateWhere it appearsWhat it asks
How did you hear about us?Order confirmationOne source question, so you can compare revenue by channel
Checkout satisfaction (CSAT)Order confirmationA 1–5 score, plus a follow-up when the score is low
NPS after fulfillmentEmail after the order is completed0–10 “would you recommend us?” with an optional comment
Why did you buy?Order confirmationPurchase reason, for merchandising and ads
What is stopping you?Exit intentWhy someone is leaving the cart
Product page feedbackProduct pageQuestions about the product, not during checkout
Delivery experienceWooCommerce order emailShipping satisfaction after the order
Refund / return reasonEmail after a refunded statusWhy the order was refunded
My Account pulseMy AccountA short NPS for customers who are logged in
In-store / kiosk CSATShortcode or blockA counter tablet, with optional order-number lookup

Where a survey can appear

↑ Back to top

Checkout is skipped on purpose. Do not look for a survey in the checkout form.

PlacementWhen the customer sees it
Order confirmation (thank you)After payment, on the order-received page. Classic checkout and the block order-confirmation page.
WooCommerce order emailsA link in the customer emails you select. Default is the completed-order email.
After an order status (delayed email)A WooCommerce email after the status you choose. Set Delay (days) after status to 0 to send when the status changes, or to 3 to wait three days. Each order is emailed once for that survey.
Product pageOn a single product.
Cart pageOn the cart.
Shop / catalogOn the shop page.
Exit intentWhen the visitor moves to leave the storefront.
My AccountOn the account dashboard for logged-in customers.
Shortcode / block / kioskOnly where you place the shortcode or the Customer Survey block.

Email and delayed-email surveys open a link that includes the order. That link is signed. A link with an order number and no valid token does not load the order.

Layout

↑ Back to top
LayoutHow it looks
InlineSits in the page content. Use this on the thank-you page and in My Account.
ModalA dialog over the page.
Slide-inA panel from the side.
BannerA bar over the page.

Modal, slide-in, and banner are printed in the page footer so the theme header does not cover them.

Display options

↑ Back to top
SettingWhat it does
One question at a timeShows one question, then Next. Turn off to show the whole form.
Show progressShows which question the customer is on.
Intro messageText above the first question.
Thank-you messageText after a successful submit.
Submit labelButton text. Blank uses “Submit”.
Accent colorButton and highlight color. Blank uses the store accent.

Questions

↑ Back to top
TypeCustomer inputUsed in reports as
Single choiceOne optionAnswer counts. Revenue by answer when this question is tied to an order, as described under Analytics
Multiple choiceMore than one optionAnswer counts. Revenue by answer on order placements when the survey purpose is Attribution
DropdownOne option from a listAnswer counts. Revenue by answer on order placements when the survey purpose is Attribution
Yes / NoYes or NoAnswer counts
NPS (0–10)Score from 0 to 10NPS score, promoters, passives, detractors
CSAT (1–5)Score from 1 to 5CSAT average
CES (1–7)Score from 1 to 7CES average
Star rating (1–5)StarsAverage, with CSAT
Short textOne lineRecurring words
Long textA paragraphRecurring words

Question key is the name stored with the answer, such as source or nps. Reports and conditional logic use this key. Change it before you collect answers. Changing it later splits old and new answers into different keys.

Allow “Other” adds a free-text option on a choice question.

Required blocks submit until that question is answered.

Show a question only in some cases

↑ Back to top

Turn on Use conditional logic on a later question. Pick an earlier question key, an operator, and a value.

Example: show “What went wrong?” only when the CSAT question key csat is less than 4.

Operators: equals, does not equal, contains, greater than, less than.

Who sees the survey

↑ Back to top

Leave a targeting field empty to skip that rule. A customer must match every rule you set.

SettingWhat it does
Sample rate (%)100 shows the survey to everyone who matches. 50 shows it to about half of visitors. Shop managers still see the survey while they are logged in, so you can check it on the store.
Once per orderOn by default. The same order cannot submit that survey twice.
Once per customerOne response per customer for that survey. Needs a logged-in user or an email on the order.
Wait (days) before asking againAfter a response, hide the survey from that customer for this many days. 0 means no wait.
Active from / Active untilShow the survey only between these dates. Leave blank for no date limit.
Minimum order total / Maximum order totalOnly orders inside this range.
Show for these productsThe order or product page must include at least one of these products.
Hide for these productsHide the survey if any of these products are present.
CategoriesLimit to selected product categories.
CountriesBilling country on the order.
Payment methodsGateway used on the order, such as Stripe or PayPal.
Customer typeAnyone, guests, logged-in customers, new customers, or returning customers.
Coupon code containsThe order used a coupon whose code contains this text.

These limits are checked again when the customer submits. Turning a survey off in the browser does not create a second coupon.

Coupon reward

↑ Back to top

You can give a unique coupon after a completed response.

  1. Create a normal WooCommerce coupon and publish it. This is the template. It is not the code the customer receives.
  2. Edit the survey. Under Rewards, choose Clone a coupon for each response.
  3. Select that template coupon.
  4. Save.

For each completion that has an email address, the plugin creates a new single-use coupon:

  • Same discount type and amount as the template
  • Usage limit 1, and 1 per customer
  • Restricted to that customer’s email
  • One reward for that survey on the same order, or for the same customer

If the order has no email, no coupon is created. Guest checkout still works when WooCommerce has collected a billing email.

The code is shown after submit and noted on the order when order notes are enabled.

What is saved on the order

↑ Back to top

Per survey, you can turn these on:

SettingWhat it does
Add answers to the order noteWrites the answers into an order note so support can read them on the order.
Save answers on the orderStores the answers in order meta.
Email the store when someone respondsSends a notice to the address in Settings.

There is also a Customer Surveys box on the order screen (including HPOS orders) that lists responses for that order.

Store settings

↑ Back to top

WooCommerce → Customer Surveys → Settings

SettingWhat it does
Accent colorDefault button and highlight color when a survey does not set its own.
Email the store when someone respondsSends an email when a survey is completed if this is on, or if the same switch is on for that survey.
Notification emailAddress for that notice. Shown when the store switch above is on. Blank uses the WordPress admin email.
Weekly insights emailSends a weekly email with completions from the last 30 days, NPS when there is a score, and recurring words from active surveys.
Digest emailAddress for the weekly email. Shown when weekly insights are on. Blank uses the WordPress admin email.
Send a browser event (gtag / dataLayer)When on, the storefront sends csfw_survey_start and csfw_survey_complete with the survey ID. Your site must already load gtag or Google Tag Manager. This plugin does not add a Google tag.
Add answers to the order noteStore-wide switch. An order note is written if this is on or the same switch is on for that survey.
Save answers on the orderStore-wide switch. Order meta is saved if this is on or the same switch is on for that survey.
Allow order number on kiosk surveysOn a kiosk survey, the customer can enter an order number so the answer is linked to that order.

Responses

↑ Back to top

WooCommerce → Customer Surveys → Responses

Each row is one completed survey: date, survey title, order, email, channel, order total, and answers.

  • Filter by survey.
  • Search by email or order ID.
  • Export CSV downloads the rows for the current filter.

The order total uses the currency stored on that response. A US order shows as dollars. An India order shows as rupees. The plugin does not convert one into the other.

Analytics

↑ Back to top

Open WooCommerce → Analytics → Customer Surveys.

The report uses the same date range and comparison controls as other WooCommerce Analytics reports. Use the survey filter to look at one survey. A survey only shows the numbers its questions can produce. An NPS survey shows NPS. A “how did you hear about us?” survey shows revenue by answer. A cart question with no order shows completions, not revenue.

NumberMeaning
CompletionsFinished responses in the date range.
Linked ordersDistinct orders that have a response. One order that answered two surveys counts once.
Linked order revenueSum of those order totals, in the currency the customer paid.
Average order valueLinked revenue divided by linked orders, per currency.
NPSPromoters (9–10) minus detractors (0–6), as a percentage of all NPS answers. 7 and 8 are passives. Score runs from -100 to 100.
CSATAverage of 1–5 satisfaction or star answers.
CESAverage of 1–7 effort answers. Lower usually means the task felt easier.

More than one currency

↑ Back to top

Revenue is not converted to your store currency.

  • If every linked order is in pounds, the total is in pounds.
  • If one order was paid in USD and another in INR, you see both amounts side by side, such as $50.00 · ₹4,700.00.
  • The symbol comes from the order currency, not from a fixed dollar sign.

WooCommerce → Analytics → Revenue is still the place for a single store-currency sales total. This report answers a different question: which orders answered, and what those customers paid.

Revenue by answer

↑ Back to top

This table is for surveys on the thank-you page, in an order email, or in a delayed order email. It groups a choice question by answer and shows completions, linked order revenue, and average order value. It includes a question whose key is source, motivation, or blocker, and any single-choice, multiple-choice, or dropdown question when the survey purpose is Attribution. Mixed currencies stay separate inside that answer. They are not added into one number. Exit-intent, product, cart, shop, My Account, and shortcode surveys are not given this revenue table, because those placements are not tied to a placed order.

Recurring words

↑ Back to top

Open-text answers are grouped by words that show up often. This runs on your server. No answer is sent off the site for this, and there is no extra account to connect.

Download

↑ Back to top

Use Download on the report to export responses for the date range and survey you are viewing.

Shortcode, block, and kiosk

↑ Back to top

Place a survey on a page, a tablet, or a POS screen.

Shortcode:

[customer_survey id="12"]

Kiosk layout, with a larger screen and optional order-number lookup:

[customer_survey id="12" kiosk="1"]

id is the survey ID from the survey list or from the shortcode shown on the survey. The survey must be Active, and its placement should be Shortcode / block / kiosk.

In the block editor, add the Customer Survey block and choose the survey. Turn on kiosk in the block settings when the page is a counter tablet.

If Allow order number on kiosk surveys is on, the customer can type an order number. The answers are then stored against that order.

REST API

↑ Back to top

Read surveys and responses from your own tools. Requests must be authenticated as a user who can manage surveys.

Base path: /wp-json/customer-surveys/v1

Method and pathReturns
GET /surveysSurvey list
GET /surveys/{id}One survey, including questions
GET /responsesResponses. Query args: survey_id, search, page, per_page
GET /reports/attributionRevenue by answer. Optional survey_id
GET /reports/npsNPS breakdown. Optional survey_id
GET /responses/exportCSV. Optional survey_id, after, before (YYYY-MM-DD). Needs a user who can view WooCommerce reports or manage surveys.
GET /analyticsThe Analytics report payload. Optional survey_id, after, before, page, per_page.

Privacy

↑ Back to top

Answers can include the customer email, order number, country, and the order total.

  • Optional Require consent on a survey shows a checkbox. The customer must tick it before submit. Write your own consent text.
  • WordPress Tools → Export Personal Data and Erase Personal Data include Customer Surveys. Erase deletes responses for that email address.
  • A suggested privacy-policy paragraph is registered for Settings → Privacy. Add it to your public policy if you use surveys.

Suggested wording you can adapt:

If you complete a store survey, your answers may be stored with your order number and email so the shop can improve products and marketing. You can ask for that data to be exported or deleted with your other personal data.

Permissions and safety

↑ Back to top
  • Only administrators and shop managers can build surveys and read responses, unless you grant stackwc_csfw_manage to another role.
  • Admin actions use a nonce.
  • Public submit is rate-limited, and a hidden honeypot field blocks empty bot posts.
  • Choice answers are checked against the options you defined.
  • Order notes and order meta are written through WooCommerce, so HPOS and the legacy orders table both work.
  • Uninstall removes the plugin tables, settings, the custom capability, and scheduled survey emails.

Suggested setups

↑ Back to top

Find out which channel pays for itself

↑ Back to top
  1. Use the template How did you hear about us?
  2. Keep the placement on the order confirmation page.
  3. Leave Once per order on.
  4. Set the survey to Active.
  5. After orders come in, open Analytics → Customer Surveys, filter to that survey, and read Revenue by answer.

You will see how much order value sat next to “Google”, “email”, “a friend”, and so on. Compare currencies separately if you sell in more than one.

Ask about delivery a few days later

↑ Back to top
  1. For a score a few days after delivery, use NPS after fulfillment. Placement is already After an order status, status Completed, delay 3 days. Change the delay if your shipping time is different.
  2. For a delivery score inside the completed-order email, use Delivery experience. That template uses WooCommerce order emails, not a delayed status email.
  3. Turn on the coupon only if you want a reward. The customer needs an email on the order.

The delayed NPS email is scheduled once for that order and survey. Once per order is on, so a customer who already answered is not asked again on the same order.

Catch people leaving the cart

↑ Back to top
  1. Use What is stopping you?
  2. Placement is already Exit intent, and the layout is a modal. You can change the layout to slide-in or banner.
  3. Do not expect order revenue on every row. The visitor may not have an order yet.
  4. Read completions and the answer breakdown. Use the comments for the reasons you did not list.

Counter tablet

↑ Back to top
  1. Use In-store / kiosk CSAT.
  2. Create a WordPress page and add [customer_survey id="YOUR_ID" kiosk="1"].
  3. In Settings, leave Allow order number on kiosk surveys on if staff want the score attached to an order.
  4. Open that page full screen on the tablet.

FAQs

↑ Back to top

Where do I read the results?

  • Open WooCommerce → Analytics → Customer Surveys for charts and totals. Open WooCommerce → Customer Surveys → Responses for each answer. If Analytics is turned off, the report stays on the Customer Surveys tab.

Does this replace WooCommerce Analytics revenue?

  • No. Analytics → Revenue is the sales report in the store currency. Customer Surveys lists the orders that answered, in the currency those customers paid. A 50 dollar order and a 4700 rupee order stay as two amounts. They are not converted into one total.

Will a survey show during checkout?

  • No. Checkout is skipped. Use the thank-you page, a WooCommerce email, a delayed email after an order status, the product page, the cart, the shop, exit intent, My Account, or a shortcode.

Does it work with HPOS?

  • Yes. Order totals, order notes, and order meta go through the WooCommerce order API, including High-Performance Order Storage.

Does it work with Cart and Checkout blocks?

  • Yes. The survey is not placed inside the checkout block. It can show on the order confirmation page after checkout, and on the other placements listed above.

Do I need another survey account?

  • No. Questions, answers, and reports stay in your WordPress database. There is no API key to connect.

Why does revenue show the wrong currency symbol?

  • Each linked order is shown in the currency the customer paid. If every order in the report uses the store currency, you see that symbol, such as pounds on a GBP store. If orders were paid in more than one currency, each total is listed on its own. Amounts are not converted.

Can the same customer submit twice and get two coupons?

  • Once per order is on by default, and that limit is checked again when the form is submitted. One reward is issued for that survey on the same order, or for the same customer email. The coupon only works for that email. No coupon is created when the order has no email.

Can I put a survey on a custom page?

  • Yes. Use the customer_survey shortcode or the Customer Survey block. The survey must be Active and its placement must be Shortcode / block / kiosk. For a tablet, set the shortcode attribute kiosk to 1.

Who can manage surveys?

  • Administrators and shop managers. The capability is stackwc_csfw_manage.

Can I export answers?

  • Yes. On Responses, use Export CSV. On Analytics → Customer Surveys, use Download. A user who can view WooCommerce reports, or who can manage surveys, can also request GET /wp-json/customer-surveys/v1/responses/export.

What happens if a customer asks for their data to be deleted?

  • Run Tools → Erase Personal Data for their email. Customer Surveys is registered as an eraser and deletes responses stored for that email. Tools → Export Personal Data includes those responses as well.

Related Products

WooCommerce Subscriptions is a WooCommerce extension that lets customers subscribe to your products or...

Offer add-ons like gift wrapping, special messages or other special options for your products.

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.