Black Friday Offer

Pro is here. Save 50% on every license during Black Friday month.

00d 00h 00m 00s Claim the offer

Advanced CSV Import (Pro)

Updated October 31, 20262 min read

Advanced Import tests your file with a dry run before anything changes, and it can also update existing terms.

Step 1: Choose the taxonomy

  1. Go to WP Taxonomy → Data Manager → Advanced Import.
  2. Click the card of the target taxonomy.
  3. Click Continue to CSV upload.

Figure 27. Choosing the target taxonomy.

Step 2: Upload and map the file

The import mode decides what happens to each row:

  • Create and update: creates missing terms and updates matching ones.
  • Create new only: skips every term that already exists.
  • Update existing only: skips rows that do not match an existing term.
  1. Select the import mode.
  2. Under Fields to update on existing terms, untick the fields that must not change.
  3. Click Choose File and select your CSV file. By default, files can have up to 5 MB and 5,000 rows; you can change these limits in Settings.
  4. Check Map CSV columns. To reuse this mapping later, type a name in Save current mapping as and click Save mapping. Saved mappings are listed in Saved mapping.
  5. Click Run dry import preview.

Figure 28. Import mode, fields to update, and column mapping.

Step 3: Review the dry run

The dry run shows what the import would do to every row: Create, Update, Skip, or Error, with the reason. Nothing has changed yet.

  1. Read the totals and the row details.
  2. If there are errors, click Download error report (CSV), fix the rows, and click Change CSV to upload the corrected file.
  3. When you are ready, click Import N ready rows.

Figure 29. The dry run found one update, one new term, and two errors: a missing parent and an empty name.

Step 4: Import

The import runs in the background in small batches, so you can leave the page and come back to check progress. If a job pauses or stops, open the page again to resume it.

Figure 30. The import running in the background.