Skip to main content

Customers

Import customers from a CSV file and fix a customer record that looks wrong.

Customers are the people you collect feedback from. Email surveys go to customers, and audience rules choose which ones get each survey. They're listed on the Customers page.

How it works

Each workspace has one customer per email address. The first time an address arrives, it creates a customer, and every later arrival updates that customer.

Customers come from:

  • Survey responses that include an email address

  • New customer, under Add customers

  • CSV imports

  • The API

  • Contact syncs and other integrations

Besides the email address, a customer can have a name, a company, an external ID, a language, tags and custom attributes. Custom attributes hold anything else you keep about customers, such as their plan, region or account manager.

No source has priority. Each one sets the details it carries, and the latest one wins. Survey responses set a name, external ID or company only when they carry a value for it, so a response with a blank company leaves the customer's company alone.

Responses without an email address don't create a customer, so they show as Anonymous.

The Customers page lists every customer in the workspace, whether or not they've left feedback. Owners and Admins see all of them. Managers and Collaborators see only customers with responses on surveys they can access, and so does anyone whose custom role sets Customers visibility that way.

Find a customer

To find someone, click Add filter, choose Customer, and enter their name or email address. The page doesn't have a search box.

You can also filter by Company, Tags, Language, Subscribed and any custom attribute. Add each filter once, giving it several values if you need to: customers matching any value show up. Add more filters, and customers have to match all of them. For a custom attribute, enter its exact value.

The list starts with the most recently modified customers and loads 50 at a time, with Load more at the bottom. Click a column header to sort by that column. Custom attributes aren't columns, so you can't sort by them.

You can't save filters as views, but the page's address keeps them, so you can bookmark a filtered list or share its link.

View a customer

Click a customer's row to open their record, which lists their responses, newest first. You see only responses on surveys you can access.

To rank customers by score, use the Customer leaderboard in Survey dashboards, since the record doesn't show one.

a customer's record with their details and tags beside their responses, newest first

Add a customer

Owners and Admins can add customers, and so can anyone whose custom role has Manage customers.

  1. On the Customers page, click Add customers, then New customer.

  2. Enter an Email, and a name and company if you have them.

  3. Click Create customer. Their record opens.

If the address already belongs to a customer, you'll see "This email already exists. Use a different one to continue." Find them with the Customer filter instead.

the Create a customer window with Email, Name and Company

Import customers from a CSV file

Owners and Admins can import customers, and so can anyone whose custom role has Manage customers.

Each row is matched to a customer by email address. Rows for people you already have update those customers and keep their feedback history, so you never get duplicates. The rest become new customers. The columns need to be in a set order, shown after the steps.

  1. On the Customers page, click Add customers, then Import customers. The same import also opens from Import customers on the Publish step of one-off email, ongoing email and web embed surveys.

  2. Drop your CSV file into the window, or select it from your computer.

  3. Import review shows how many rows are ready, how each column maps to a field, and which rows will be skipped and why. Note the skipped rows now, because nothing else lists them. Its row 1 is the first row after your header, which is row 2 in a spreadsheet. If anything's wrong, fix the file and start again. Otherwise, click Next step.

  4. Tag these customers shows the import's own tag, CSV Import with the import's date and time in UTC. Add any other tags you want, then click Import.

the Import review step with its Field in Simplesat, Column header in CSV and Sample field table

We'll email you when the import finishes to say whether it worked, though the email doesn't give a row count. Customers the import created or updated show at the top of the list, sorted by Modified. Imports only ever add tags, never remove them.

Your file needs to be a CSV saved in UTF-8, not an Excel file (.xlsx), with commas or semicolons between columns. It can be up to 50 MB, with any number of rows.

The first row is the header. Columns are read by position, so put them in this order:

Column

Holds

A

First name

B

Last name

C

Email (required)

D

Company

E

Language

F onward

Custom attributes, one per column, named by the header

Include columns A to D in every row, even if you leave the names and company blank. If your file has only an email column, it won't import at all. Rows with fewer than four columns, an accented letter before the @ in the email address, or a name or company over 256 characters are skipped without being listed anywhere, not even on Import review.

For a file that's already in this layout, use the template CSV linked in the import window. Delete its sample row, [email protected], or it imports as a customer.

Leave a first name, last name, company or language blank to keep what the customer already has. For language, use a code Simplesat recognizes, such as en, fr or zh-CN, in any letter case, or the row is skipped.

Each column from F onward sets a custom attribute, named by its header. To update an attribute you already have, match its name exactly, letter case and spaces included, because any other header creates a new attribute. If you leave a cell blank, the import removes that attribute from that customer. Attributes that aren't in the file stay as they are.

Heads up: Custom attributes can't be deleted, and their names stay in the filter list and the export, so check every header before you import. A typo leaves a stray attribute behind for good.

Write dates in ISO 8601, such as 2026-03-15 or 2026-03-15T14:30:00Z, so they're read as dates. In a new column, other formats such as 03/15/2026 are saved as text. In a column that already holds dates, a row in another format is skipped.

Edit a customer

Owners and Admins can edit customers, and so can anyone whose custom role has Manage customers.

  1. Open the customer.

  2. Click the ⋮ menu at the top right, then Edit.

  3. Change the Name or Company, then click Save.

The new name or company shows on all the customer's past responses. If an integration or a survey link sends the old one again, it overwrites your edit, so fix it in the tool that sends it as well.

You can't change a customer's email address. To change their language or custom attributes, import them again.

Tag customers

Owners and Admins can tag customers, and so can anyone whose custom role has Manage customers.

On a customer's record, click Add tag under Tags. To remove a tag, click the × on it.

To tag several customers at once, including ones you already have, import them and add the tag at the Tag these customers step.

To survey a tagged group, such as the customers from one import, use the tag in an email survey's audience rules, which Direct email surveys walks through.

Customer tags are separate from the tags you put on responses in Feedback.

Custom attributes

To add a custom attribute, include it as a column in a CSV import, or send it through the API or an integration. It appears with its first value, so there's nothing to set up.

Custom attributes show on each customer's record. You can also use them in:

  • The Customers and Feedback filters

  • Audience rules for email and web embed surveys

  • The customer export

  • The API

Details you send on a survey link, such as a ticket ID, are saved on the response, not on the customer. Placeholders and merge fields explains how to send them.

Unsubscribe or resubscribe a customer

Owners and Admins can unsubscribe and resubscribe customers, and so can anyone whose custom role has Manage customers.

  1. Open the customer.

  2. Click the ⋮ menu at the top right.

  3. Click Unsubscribe or Resubscribe. It applies at once, and an unsubscribed customer's record shows Unsubscribed from emails.

the menu at the top right of a customer's record with Edit, Unsubscribe and Delete

Unsubscribing stops every survey email Simplesat sends, leaving the customer out of:

  • Email audiences

  • One-off and ongoing sends

  • Follow-up reminders

  • Event-based sends

Heads up: Unsubscribing doesn't stop survey links sent by your own helpdesk or email tool, and doesn't hide web embed surveys from the customer. Their responses still arrive.

Customers can also unsubscribe themselves from the link in a survey email, and resubscribe from the page that link opens. If someone unsubscribed themselves, resubscribe them only after they've told you they want survey emails again.

To see who's unsubscribed, check the Subscription status column, set the Subscribed filter to false, or look at the Subscribed column in an export.

Imports, contact syncs and the API can't change whether someone is subscribed. If another tool, such as your helpdesk, syncs an opt-out flag, it arrives as a custom attribute and doesn't unsubscribe anyone. To leave those customers out, add an audience rule on that attribute.

Export customers

Owners, Admins and Managers can export customers, and so can anyone whose custom role has Export customers.

  1. On the Customers page, set any filters you want.

  2. Click Export customers.

  3. Choose Export only filtered customers or Export all customers, then click Export customers.

We'll email you a link to the CSV file, from [email protected] to the address you sign in with. You can close the page while you wait, which at busy times can be a few hours. If your filters match no one, you won't get an email.

The file has First Name, Last Name, Email, Company, Language as a code and Subscribed as True or False, then every custom attribute in the workspace.

Tip: To change several customers at once, export them, edit the file, delete the Subscribed column, and import it again. If you leave Subscribed in, the import turns it into a custom attribute.

Delete customers

Owners and Admins can delete customers, and so can anyone whose custom role has Manage customers.

To delete one customer:

  1. Open the customer and click the ⋮ menu.

  2. Click Delete, then Delete customer.

To delete several:

  1. Check the box next to each customer in the table.

  2. Click Delete, then confirm.

the Customers page with customers checked and Delete beside the count selected

Warning: Deleting a customer is permanent and can't be undone. Their responses stay, but show as Anonymous.

If a survey response, an integration or an import sends the same email address later, it creates a new customer. To stop survey emails to someone without deleting them, unsubscribe them instead.

Troubleshooting

My customer CSV import failed

The failure email means the file couldn't be read. Save it as a CSV in UTF-8, with commas or semicolons between columns, not tabs. If your file has only an email column, it fails too, because every row needs columns A to D, with the email in column C. If a file that always imported now fails, contact us with the file and we'll look at what changed.

If you'd rather not fix the file yourself, send it to us by chat or email, and we'll import it for you. The file is all we need, though you can also tell us a tag to add to the customers.

My import said it completed but no customers appeared

Rows whose email matched an existing customer updated that customer instead of adding one. You'll find them at the top of the list, sorted by Modified.

Rows are skipped if the email isn't in column C, for example in a file exported from another tool with its own column order. A few more are skipped after Import review without being listed anywhere: rows with an accented letter before the @ in the email address, a name or company over 256 characters, or fewer than four columns.

If your role sees only customers with responses on surveys you can access, new customers without responses won't show for you.

I only want to upload email addresses

Keep columns A to D, put the email addresses in column C, and leave the first name, last name and company blank. Blank names and companies don't overwrite what existing customers already have.

What is UTF-8 and how do I save my file that way?

UTF-8 is a way of saving text that keeps accents and other characters intact. In Excel, choose File → Save As, then CSV UTF-8. In Google Sheets, File → Download → Comma-separated values saves as UTF-8.

We have anonymous responses

Responses without an email address don't create a customer, so they show as Anonymous. Check that your survey link or integration sends the customer's email address. For a survey link, see Placeholders and merge fields.

A customer has the wrong name or company, or keeps changing back

Each survey response, import or integration sets the details it carries, and the latest one wins. If a contact sync or a survey link sends the wrong value, it comes back after you edit the customer. Fix it in the tool that sends it.

A customer shows under the wrong company

The company comes from the latest response, import or integration that set one for that email address. Check whether a contact sync or a survey link is sending it. Edit the customer to fix it, and fix it at the source so it doesn't come back.

I can't see the Edit or Delete options on a customer

Editing, tagging, unsubscribing and deleting customers need an Owner, an Admin or a custom role with Manage customers. Ask an Owner or Admin to change your role.

A response I know was submitted isn't showing on the customer

Check the email address on the response's survey link, because a different address puts the response on a different customer. Then check that you have access to that survey. If it's still missing, contact us with the customer's email address, the survey name and the ticket ID.

FAQ

Is there a limit on the number of rows in a customer import?

No, though the file can be up to 50 MB.

How do I update many existing customers at once?

Export them, edit the file, delete the Subscribed column, and import it again. Rows match by email address and update the existing customers.

How do I survey exactly the customers I just imported?

Every import tags its customers with CSV Import and the import's date and time. Use that tag in your email survey's audience rules.

Can I change a customer's email address?

No. The email address is what identifies a customer, so a new address makes a new customer, and the responses stay with the old one.

Can I sort customers by a custom attribute?

No. You can filter by one, though, as long as you match its value exactly.

How do I stop one person from receiving survey emails?

Open the customer and click Unsubscribe in the ⋮ menu.

How do I resubscribe a lot of customers at once?

Open each customer and click Resubscribe in the ⋮ menu. Customers can also resubscribe themselves from the page that opens when they click the unsubscribe link in a survey email.

How do I stop all survey emails?

Pause your ongoing email surveys and close the others. Direct email surveys and Survey settings show how.

Can I bring my customers over from another feedback tool?

Yes. Export them from that tool, reorder the columns to match Simplesat's, with the email in column C, and import the file. Past feedback has its own import, described in Importing feedback.

Did this answer your question?