How to Import WordPress Categories and Tags

To import WordPress categories and tags, navigate to WP All Import › New Import. Specify your import source, select Taxonomies for the import type, then choose the specific taxonomy (such as category or tag) as your import target. Use the Drag & Drop interface to map the incoming data elements to their target fields.

WP All Import automatically detects all available taxonomies including custom categories and tags.

Understanding WordPress Categories and Tags

WordPress uses taxonomies to group posts, products, and other post types together based on relationships. Two taxonomy types are available by default: Categories and Tags. Categories are used to group post topics, while tags are used to describe posts in more detail.

Categories can also contain hierarchies. For example, an e-commerce store may have a Women's Clothing category with subcategories like Winter Wear, Everyday Wear, and Beach Wear. Winter Wear itself may have other subcategories like Jackets, Snow Pants, and Underlayers.

In this model, the Jackets subcategory is considered to be the child of Winter Wear, while Winter Wear is the child of Women's Clothing.

When WooCommerce is installed on a WordPress site, it adds custom taxonomies such as Product categories, Product tags, and Product type, among others. Attributes are also added as a taxonomy.

Plugins and themes are free to add their own custom categories and tags. For example, a fitness company may create categories for Fitness Level and Experience Level so that they can group their members accordingly. They may also add descriptive tags like Shy, Outgoing, Competitive, etc., to help members more accurately describe themselves.

You can read more about WordPress taxonomies here: https://wordpress.org/support/article/taxonomies/.

Importing Taxonomies With Posts vs Importing Taxonomies on Their Own

Taxonomies are usually created when importing posts. However, there may be cases where you want to import categories and tags separately from posts. That is the subject of this tutorial.

We will be using an e-commerce clothing store for this example. Thus, we import Product categories.

Step 1: Create a New Import for WordPress Categories or Tags

Navigate to All Import › New Import:

Import WordPress Categories Create New Import

Upload your file, select Taxonomies as the import type, choose the desired taxonomy (such as category or tags) and click Continue to Step 2.

Step 2: Review the WordPress Category/Tag Import File

The Review Import File interface allows you to check whether WP All Import has correctly parsed the incoming data:

Import WordPress Categories Review Import File

As you can see, WP All Import has detected 112 incoming records. You can use the gray arrows in the top corners of the middle panel to iterate through the individual records.

The data looks good so click Continue to Step 3.

Step 3: Map the Incoming Data Elements to the Target Category or Tag Fields

The Drag & Drop interface lets you map the incoming data elements to the target fields. To do this, simply drag data elements from the Available Data section on the right to the appropriate fields on the left. In this case, we are dragging the incoming termname and description data elements to the corresponding fields in the Name & Description panel.

Import WordPress Categories and Tags Name and Description

You would take this same action for a tag import and also for most custom taxonomies provided they adhere to convention.

If you were importing tags, this is the only mapping that is required.

For categories, close the Name & Description panel and expand the Other Category Options panel. Here, drag the incoming parentname data element to the Parent Term field.

Import WordPress Categories and Tags Parent Term

This mapping is used to import the hierarchal relationships between categories. Note that we used parentname here but we could have also used parentid or parentslug. WP All Import will handle any of the three.

Note, also, that these instructions apply to built-in categories/tags as well as custom taxonomies. However, in some cases, full data mapping may involve custom code.

Click the blue Continue to Step 4 button at the bottom.

Step 4: Configure the Category/Tag Import Settings

The Import Settings screen allows you to configure some important options for your import:

Import WordPress Categories and Tags Import Settings Screen
  1. Click the Auto-detect button. This will automatically identify a unique identifier for the taxonomies in your import file.
  2. You do not have to worry about this set of options for an import of new categories or tags. But if you re-run this import, this set of options lets you instruct WP All Import on how to handle issues such as whether the import should delete or update existing categories/tags.
  3. Click Continue.

Step 5: Confirm and Run the WordPress Categories/Tags Import

The Confirm and Run screen allow you to confirm some final settings before running the import:

Import WordPress Categories and Tags Confirm and Run

Here you can review the settings in the Import Summary section. Click on Confirm & Run Import to continue.

The import will then run. When it completes, WP All Import will bring up this screen:

Import WordPress Categories and Tags Import Complete Screen

To confirm that everything worked as expected, navigate to Products Categories in the WordPress main menu. There, you should see all of your imported product categories correctly.

Frequently Asked Questions

How Do I Import WordPress Categories or Tags with Posts?

  1. Configure your WordPress posts import as usual.
  2. In the Drag & Drop interface, there is a Taxonomies, Categories, Tags section that allows you to specify how to handle incoming categories and tags. Note, there are two ways to handle hierarchal relationships.

For more information, see Import WordPress Taxonomies.

How Do I Export WordPress Categories or Tags?

  1. Go to All Export New Export.
  2. Configure your export columns using the Drag & Drop interface.
  3. Run the export.
  4. Download your export file.

For more information, see How to Export WordPress Categories and Tags.

How Do I Migrate WordPress Categories or Tags to Another Website?

  1. Export the categories or tags for migration, but instead of downloading a CSV file, download the bundle zip file. In addition to your export data file, this file also includes an import template that tells WP All Import how to handle the export file.
  2. Using WP All Import, import the bundle file on the target site. All you need to do after that is accept the default settings, as WP All Import will automatically handle the rest of the import.

For more information, see Migration Overview.


Related Docs

Import metadata into your categories or tags.

Export WordPress posts along with their assigned taxonomies (such as categories or tags).

Export WordPress categories or tags directly, without exporting the associated posts.

Lifetime support. Lifetime updates. Pay once.

Packages
Standalone
Import
Pro Package
$249
one-time
  • Import Pro
Import Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
  • Types
  • Export Pro
Export Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
Add to Cart
90 Day Money Back Guarantee
Import + Export Pro Package
$299
one-time
  • Import Pro
Import Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
  • Types
  • Export Pro
Export Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
Add to Cart
90 Day Money Back Guarantee
WooCommerce Import Package
$149
one-time
  • Import Pro
Import Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
  • Types
  • Export Pro
Export Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
Add to Cart
90 Day Money Back Guarantee
Import Standalone
$99
one-time
  • Import Pro
Import Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
  • Types
  • Export Pro
Export Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
Add to Cart
90 Day Money Back Guarantee
Import + Export Standalone
$169
one-time
  • Import Pro
Import Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
  • Types
  • Export Pro
Export Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
Add to Cart
90 Day Money Back Guarantee
Export Standalone
$99
one-time
  • Import Pro
Import Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
  • Types
  • Export Pro
Export Add-Ons
  • WooCo
  • ACF
  • Gravity Forms
  • Users
Add to Cart
90 Day Money Back Guarantee
cross