Permissions

The permissions tab of the importer screen allows you to control if records can be inserted, updated or deleted.

Unique identifier

Import WP uses a unique identifier to determine if a record should be inserted / updated / or deleted, either by using a previously populated template field or by creating a custom identifier made from one or more sections of the import file.

Please note the unique identifier search against all items including those that have been deleted and are still in the trash folder.

Please also note changing a unique identifier type/value between imports can cause duplicate records or data loss.

Use a template field as the unique identifier

Using a template field as the unique identifier works best when you are importing objects that already import a reference field in the template such as an sku on a product, or a isbn number on a book.

The template field dropdown displays a list of all possible fields that have been populated when mapping importer fields/data, hiding template fields that have no content or are not enabled.

Import WP unique identifier dropdown listing mapped template fields such as SKU

If you cannot find a template field that you have populated with content previously, you can type its name into the dropdown and click on the create option to use it.

Import WP unique identifier dropdown with a typed field name and Create option

Use a custom identifier from the import file

Using a custom value as a unique identifier works best when you want to create an identifier from a section of the import file that in not already being imported, or if you are creating an identifier from a combination of nodes/columns.

You can select one or more sections of your import file by clicking on the select button that will display the visual data selector window.

Import WP unique identifier built from one or more columns via the visual data selector

Restrict which fields can be imported

This section allows you to limit what the importer can do either create / update / or delete, each can be refined further to allow or deny a specific set of fields / properties.

Clicking on a checkbox will expand any extra options, and allow you to save and continue onto the final step.

Import WP Permissions checkboxes expanding create, update, and delete field restrictions

The import dropdown allows you to choose what restrictions will be applied per import method.

All Fields

The all fields option means there are no restrictions for that import method.

Only the following fields

Only the following fields allows you to specify a list of fields that can be imported, enter each field or field pattern on a new line.

None of the following fields

None of the following fields allows you to specify a list of fields that will not be imported, enter each field or field pattern on a new line.

Updated 2025-06-03