When importing subscribers via the Taguchi UI, you can map a column from your import file to the Partition external ID field (partition_ref). This allows you to set or update a subscriber's partition membership as part of the import process.

How it works

In the field mapping step of the import process, search for "part" (or "partition") in the field selector. Under the Partition category, select partition_ref — Partition external ID.

Behaviour when importing partition data

Scenario	Result
Column contains a single valid partition external ID	Subscriber is assigned to that partition
Column contains multiple valid partition external IDs (separated by newlines)	Subscriber is added to all of those partitions
Column is empty or contains no valid partition external IDs	Subscriber's existing partition membership is erased
Column contains some invalid partition external IDs mixed with valid ones	Invalid IDs are ignored; subscriber is assigned to the valid partitions only

Note: Invalid partition external IDs are silently ignored. Ensure your import file uses the correct external IDs as defined in your Partitions settings.

Steps to map partition during import

1. Navigate to the Subscribers section and open the list you want to import into.
2. Upload your import file (CSV, TSV, or XLSX). Ensure it includes a column containing partition external IDs.
3. In the field mapping screen, locate the column that holds your partition external IDs.
4. Click the field selector for that column and search for "partition".
5. Under the Partition category, select partition_ref (Partition external ID).
6. Complete any other field mappings as needed, then click Start import.

Preparing your import file

Your import file should include a column with the partition external ID(s) for each subscriber. For subscribers that belong to multiple partitions, list each partition external ID on a separate line within the same cell.

Example CSV structure:

email,first_name,partition_ref
jane@example.com,Jane,store-001
john@example.com,John,"store-002
store-005"
alex@example.com,Alex,

In the example above:

• Jane will be assigned to store-001
• John will be assigned to both store-002 and store-005
• Alex's partition membership will be cleared (empty value)

Related articles

• Partitions
• Import logic via Taguchi UI
• Can I import any non-standard fields?
• Which file formats can I upload to Taguchi?

---