CSV Upload

Unwrap supports uploading feedback data via CSV file. This is a great option for importing data from sources that aren't covered by our built-in integrations — such as survey results, support tickets, app reviews, or any other customer feedback you've collected.

How to Upload

1. Navigate to the Integrations page.

2. Click New Integration and select CSV.

3. In the upload window, drag and drop your CSV file or click to browse and select a file.

4. Review the preview to make sure your data looks correct.

5. Name the Source — Give your upload a descriptive name (e.g., "2023 Q1 NPS Responses"). This name will appear as a filter option so you can easily find feedback from this upload later.

6. Custom field separator (optional) — If any of your custom field columns contain multiple values in a single cell (e.g., "billing, payments"), check the "Split values in custom field columns" box and enter the separator character (commonly , or ;). See the Custom Fields section below for details.

7. Click Submit.

Your feedback will be processed and available in Unwrap shortly. Depending on the size of your file, this may take a few minutes.

Columns

Your CSV file needs column headers in the first row. Unwrap recognizes two types of columns:

1. Standard columns — These are built-in columns that Unwrap uses for specific features (e.g., Date is used for trend analysis, Stars powers rating filters). Use the exact column names and casing shown below.

2. Custom field columns — Any column that doesn't match a standard column name is automatically imported as a custom field. You can name these anything you want. See Custom Fields for more.

Required Columns

Use the exact Column name in your CSV’s first row. Description explains what to put in that column.

Optional Columns

These columns map to built-in Unwrap features. They are not required, but including them enables additional functionality.

Each row below is one optional CSV column: Column is the header name to use, Description explains the values, and What it enables describes how Unwrap uses it.

Example CSV

Below is a simple example with standard columns only:

Title,Details,Date,User,ID,Stars,Source URL
Small portion sizes,App orders are smaller portions than in-store orders,04/12/2026,John D.,d6ah8d39d,3,https://example.com/review/123
Love the new menu,The seasonal items are a great addition to the app,04/10/2026,Sarah K.,a1bc2d3e4,5,https://example.com/review/124

Here's an example that also includes custom fields (Plan and Product Area):

Details,Date,User,ID,Plan,Product Area
App crashes when I open settings,04/12/2026,John D.,ticket-001,Pro,Mobile App
Would love dark mode support,04/10/2026,Sarah K.,ticket-002,Free,Web
Billing page doesn't load,04/09/2026,Mike R.,ticket-003,Enterprise,Web

Custom Fields

Any column in your CSV that doesn't match one of the standard column names (Details, Date, Title, User, ID, Stars, Source URL) is automatically imported as a custom field.

Custom fields let you filter and segment your feedback by any dimension that matters to your business. For example, you could add columns like:

Each row is an example custom column: Custom Field Column is a sample header name, Example Values shows typical cell values, and Use Case explains why you might use it.

Once imported, custom fields appear as filter options throughout Unwrap — in themes, trends, search, and more. You can combine multiple custom fields to drill into specific segments of your feedback (e.g., "show me feedback from Enterprise customers in EMEA about the Mobile App").

Multi-Value Custom Fields

Sometimes a single feedback entry belongs to more than one category. For example, a ticket might relate to both "billing" and "payments".

If a cell contains multiple values separated by a character (e.g., billing, payments or billing; payments), you can tell Unwrap to split them during upload:

1. Check the "Split values in custom field columns" box.

2. Enter the separator character (commonly , or ;).

Each value will be treated as a separate value for that custom field, so the entry will appear when filtering by either "billing" or "payments".

Appending New Data to an Existing Source

You can upload additional CSV files to the same source over time — for example, uploading new survey responses each quarter.

To append data to an existing source:

1. Go to the Integrations page.

2. Find the CSV integration option and click on it.

3. Upload your new CSV file with the same column structure.

(You will not be able to see the integration in the UI, but you can use the "Name the Source" field.)

How Deduplication Works

When you upload data, Unwrap checks the ID column to determine if an entry already exists:

• Entries with a new ID are added as new feedback.

• Entries with an existing ID are skipped — they will not be duplicated.

• Entries without an ID are always treated as new, which may result in duplicates if you upload the same data again.

Best practice: Always include an ID column with a stable, unique identifier from your source system (e.g., ticket number, survey response ID, record ID). This ensures you can safely re-upload or append data without creating duplicates.

Updating Existing Entries

If you need to update custom field values for entries that have already been imported (e.g., a customer's plan changed from "Free" to "Pro"), re-upload the CSV with the updated values and the same IDs. The custom field values will be refreshed for matching entries.

Frequently Asked Questions

What date formats are accepted? Unwrap accepts MM/DD/YYYY and YYYY-MM-DD. Make sure your Date column uses one of these formats consistently throughout the file.

What happens after I upload? Your feedback goes through Unwrap's analysis pipeline — it will be categorized, analyzed for sentiment, and made available across all Unwrap features, including themes, trends, and search.

Is there a limit on file size? There is no strict file size limit, but very large files may take longer to process. If you have a very large dataset, consider splitting it into multiple uploads.

Can I upload multiple CSVs to the same source? Yes. See Appending New Data to an Existing Source above.

Can I delete an uploaded data set? Contact your Unwrap account team to remove data from a specific upload.

My columns aren't mapping correctly — what should I check? Make sure your column headers match the exact names and casing shown in this guide (e.g., "Details" not "details" or "Detail"). Any unrecognized column names will be imported as custom fields.