Documentation

Create a new importer from Tools → Import WP: choose a template, pick the file source, and start mapping fields.

Selecting a file to import — Import WP documentation.

The file settings tab allows you to change all options relating to reading from the XML file, changing any option on the page should automatically refresh the preview panel.

The templates fields tab of the importer screen is where setup the link between the file being imported and what parts of the chosen import template.

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

The run import tab is where you configure what records should be imported using and any template specific settings.

The history tab on the importer screen shows a list of all previous importers, showing the latest at the top.

To create a new exporter, via the ImportWP screen (Accessed under Tools > Import WP), click on the Exporters tab at the top of the screen, this will load a page showing a list of all exporters.

Choosing export file type — Import WP documentation.

To run an export, click on the “Save & Run” button displayed at the bottom of the form.

This guide will take you through setting up Import WP Pro to schedule an importer, along with some useful tips along the way.

Skip or keep CSV and XML rows before they import, using Filter Rows on the Run Import tab or a code filter.

This article will take you through the steps to import file/images from google drive into WordPress as Attachments using Import WP.

Import a Google Sheet into WordPress posts, pages, or custom post types by sharing the sheet as a CSV URL.

Taxonomies can be imported on WordPress Pages, Posts, Custom post types, and all templates using these as a base. The taxonomy tab will appear in your importer if the post type being imported has registered taxonomies.

Attachments can be imported on WordPress Pages, Posts, Custom post types, and all templates using these as a base. Attachments can be fetched from within a local directory, remote url, or from a ftp server.

Import WordPress custom fields and post meta from CSV or XML with Import WP Pro, and update existing values.

This guide will take you through importing data from a CSV file into WordPress Pages, this same method can be applied to importing Posts, Pages, and Custom Post types.

Import WordPress users from a CSV: username, email, role, and password, and update the same accounts on the next run.

Select a taxonomy, then map term name, slug, parent, and description from CSV or XML with the taxonomy importer template.

Selecting the WordPress user template when creating your importer gives you control to select which data within your xml or csv file that links to specific WordPress user fields.

Import WP’s WooCommerce add-on allows you to easily import WooCommerce products from XML / CSV files, allowing you to import products from simple to variable product with as much information as required.

Simple products are the easiest WooCommerce product type to import. At minimum you only need a product name and a regular price.

Variable products show customers a set of choices (for example Size and Colour). In Import WP you typically import:

Product attributes describe products (Colour, Size, Brand, Material, etc.). In WooCommerce they can be:

WooCommerce products use a featured image (main product image) and an optional product gallery . Import WP can download images from remote URLs, local paths, FTP, or reuse items already in the Media Library.

Map WooCommerce product categories, tags, shipping classes, and custom taxonomies, including parent and child terms.

Update WooCommerce products from a supplier feed without duplicates by matching on SKU and setting update permissions.

Use the Inventory section of the WooCommerce Products template to import SKUs, GTINs, stock quantities, and stock status — including variation-level stock for variable products.

Map product prices in the Pricing section of the WooCommerce Products template. Prices are formatted with WooCommerce’s wc_format_decimal() before save.

Alongside simple and variable products, the WooCommerce Products template supports grouped and external / affiliate products.

Import WP Pro can run WooCommerce product imports automatically on a schedule — ideal for supplier price, stock, and catalogue feeds.

Import WP exposes filters for WooCommerce product, customer, and order fields, attributes, and related behaviour. Add snippets with a small custom plugin or the approach described in Using Code Snippets in WordPress .

This guide covers the WooCommerce import errors and failure patterns that appear most often in Import WP support tickets.

Import WooCommerce customers from CSV or XML with the WooCommerce Customers template — emails, usernames, billing and shipping addresses, and unique-key updates.

Import WooCommerce orders from CSV or XML with the WooCommerce Orders template — order key, status, customer, addresses, line items, and totals.

Import WP’s WooCommerce add-on adds a dedicated WooCommerce Products importer template so you can import simple, grouped, external, variable, and variation products from CSV, XML, and other supported sources.

If Import WP cannot see an ACF field group, relax the field group location rules so those fields appear in the mapper.

Import Advanced Custom Fields data from XML or CSV with Import WP Pro — ACF support is built into Pro, no separate add-on.

The Advanced custom fields integration for Import WP PRO allows you to import any CSV and XML files into ACF repeater fields.

Import JetEngine fields from CSV or XML, from text through media and relationships. The add-on requires Import WP Pro.

Import WP’s Polylang add-on allows you to easily import Polylang translations to post types from XML / CSV files.

Import Rightmove-style .BLM property feeds and their attachments into WordPress with the Import WP BLM add-on.

The easiest way to add custom code snippets to your WordPress website is by combing them all into a custom plugin, or by using a code snippet plugin like Code Snippets or similar.

The following code snippet hooks into the event handler and listens for the import_shutdown event, then if the import has the complete status the code will be ran.

Some WordPress fields need dates in a specific format. Use an Import WP custom method to reformat a date from your CSV or XML file before it is imported.

Register your own keys so they appear in the Import WP Pro custom field dropdown for posts, users, and terms.

The following code snippet allows you to change the file encoding of the file being imported, this is only neccessary if you see strange symbols in the importer preview.

Use the iwp/template/process_field filter to change a mapped value before it is saved, such as a post date.

Import a CSV that uses a multi-character delimiter, such as ||, instead of a single character like a comma.

Change which fields Import WP uses as the unique identifier so a repeat import updates the same posts or users.

Fix WordPress “Sorry, this file type is not permitted for security reasons” when Import WP uploads an attachment.

Register a custom Import WP template in code so you can import into your own post type, such as audio.

Import WP’s WPML add-on extends Import WP and allows you to easily import WPML translations to post types from any xml or csv file.

Import or update existing attachments in the WordPress media library, including all core attachment fields, author, custom taxonomy terms and custom fields.

Easily Import WordPress posts, pages and custom post types from any xml or csv file using ImportWP, including all post type fields, parent relationships, taxonomy terms, attachments and images, and custom fields.

Once activated if you do not have the base Import WP plugin installed or a compatiable version, a notice will appear at the top of your screen alerting you to activate / update the plugin.

Import WP Pro automatic updates can be enabled on the WordPress admin plugin screen, via the License key field shown under the Import WP Pro plugin row, automatic updates require Import WP Pro v2.9.4 .

* FIX - Prevent Importers page crash when an importer is left in a running state with an empty section.