{"id":5816533,"date":"2023-08-16T23:49:45","date_gmt":"2023-08-16T23:49:45","guid":{"rendered":"https:\/\/www.wpallimport.com\/?post_type=documentation&p=5816533"},"modified":"2025-12-08T18:32:00","modified_gmt":"2025-12-08T18:32:00","slug":"import-taxonomy-meta","status":"publish","type":"documentation","link":"https:\/\/www.wpallimport.com\/documentation\/import-taxonomy-meta\/","title":{"rendered":"Taxonomy Meta & Images"},"content":{"rendered":"\n

Most often, you will want to import categories, tags, and other taxonomies as part of an import that creates posts. There are times, however, when you will want to import just the taxonomies on their own. This is especially helpful when you have metadata like images, custom fields, and content that needs to be imported into the taxonomies themselves. This is only possible by creating an import for taxonomies.<\/p>\n\n\n\n

Just like posts, you can import new taxonomies, or you can add metadata and content to existing taxonomies. To learn how to import new taxonomies, see How to Import WordPress Categories and Tags<\/a>.<\/p>\n\n\n\n

This guide will show you how to add images and term metadata to existing category terms. <\/p>\n\n\n\n

Step 1: Choose Taxonomies When Creating the Import<\/h2>\n\n\n\n

To get started, select Taxonomies<\/strong> in Step 1 and select the target taxonomy from the second drop-down box that appears on the page:<\/p>\n\n\n\n

\"Taxonomy<\/a><\/figure>\n\n\n\n

Click Create Filters<\/strong> or Set Up Import<\/strong> to continue.<\/p>\n\n\n\n

Step 2: Review the Import File<\/h2>\n\n\n\n

If you clicked on Create Filters<\/strong>, you see this screen next. The import process will ask you to review the import file in this step. You can validate that the import file looks correct and then continue to the next step.<\/p>\n\n\n\n

\"Taxonomy<\/a><\/figure>\n\n\n\n

Step 3: Map Taxonomy Import Fields<\/h2>\n\n\n\n

In Step 3 of the import process, you can drag and drop your import data just like any other import. Supported fields include the name, description, images, term meta (custom fields), and the parent term.<\/p>\n\n\n\n

Map the image element and the term metadata as follows:<\/p>\n\n\n\n

\"Taxonomy<\/a><\/figure>\n\n\n\n

You can also define more data. For example, the parent term is defined in the Other Category Options<\/strong> section:<\/p>\n\n\n\n

\"Taxonomy<\/a><\/figure>\n\n\n\n

You can also choose whether to manually set the slug for the category or let a slug be generated automatically.<\/p>\n\n\n\n

Note<\/strong>: When importing non-hierarchical taxonomies (e.g., Tags), only the option to set the slug will appear in this section. <\/p>\n\n\n\n

Once you've mapped all fields, continue to the following step.<\/p>\n\n\n\n

Step 4: Define Match Settings Correctly<\/h2>\n\n\n\n

In the Import Settings<\/strong>, you define this to be an Existing Items<\/strong> import. You also need to map the data that will be used to match your existing taxonomy term. Following our example, we use the taxonomy's term or category ID to match:<\/p>\n\n\n\n

\"Taxonomy<\/a><\/figure>\n\n\n\n

Since you're only updating images and custom fields, you also need to define this in this step:<\/p>\n\n\n\n

\"Taxonomy<\/a><\/figure>\n\n\n\n

Once done, you can Continue<\/strong> to the next step and then click on Confirm & Run Import<\/strong> to run the import process. When the import is complete, your taxonomy terms will be updated with the new data from your import file.<\/p>\n\n\n\n

\n\n

Easiest Way to Import WordPress Taxonomies Meta<\/h3>\n