Skip to main content

​
Overview

Qwoty uses identifiers to decide whether a row creates a new record or updates an existing one, and to prevent duplicates.

​
Identifiers by resource

UUIDs are Qwoty’s internal identifiers (for example c776ee49-f608-4a77-8cc8-6fe96ae1e43f). Get them from an export.

​
Import behavior

​
Creating products

Leave product_id empty. Qwoty creates the product, its default variant, and a fresh UUID.

​
Updating records

Set product_id (products) or id (prices). Only the columns you map are modified: other fields stay untouched.
To update records, export them first: the export contains every identifier you need.

​
Duplicate detection

During validation, Qwoty flags:
  • A product_id or price id that appears more than once in the file (a price can appear only once, whether by UUID or by key)
  • A product_api_name already used by another product
  • An identifier that doesn’t match any record in your workspace
Errors don’t block the import: valid rows are imported, and you can download the failed rows to fix them.

​
Best practices

  1. Remove duplicates from your file before importing: sort it by the identifier column to spot them
  2. Export first when you want to update records, then edit that file
  3. Store external IDs in identifiers[erp], identifiers[crm], and identifiers[accounting] when migrating from another system
  4. Leave product_id empty only when you want to create new products

Field mapping

How fields are matched between your CSV and Qwoty.

Import relations

How to link records during import.

Error handling

What validation errors mean and how to fix them.

Import products

Create or update products from a CSV.
Last modified on October 27, 2026