Skip to main content

How to create category mapping

Your store calls it "Men > Footwear > Trainers". Google calls it "Apparel & Accessories > Shoes". Get that translation wrong and your products land in the wrong place, compete against the wrong things, and convert badly.

Category mapping is where you line the two taxonomies up. Map a parent and every child inherits it, so you are usually mapping a few dozen nodes rather than a few thousand.

Note

Ran out of patience halfway down the tree? An AI category mapping profile can finish the tail for you - it only looks at the products your manual mapping left unmapped.

Create a new category mapping​

1. Add a new category mapping

  • Go to Catalog -> Advanced Product Feeds -> Category mapping.
  • Click Add New Category Mapping.

2. Configure the mapping

  • Add the name for new mapping in the Mapping name field.

  • Match your store categories with the shopping engine categories. If a child category does not have a specific mapping, it will inherit the mapping from the parent category.

    tip

    When you start typing a category name, the system automatically suggests categories from the Google Shopping taxonomy file.

3. Save and use the mapping

  • Click Save to finalize the mapping.
  • You can now apply this category mapping in your product feed templates.

Custom taxonomy files​

You can add other taxonomy files (besides Google Shopping) to the extension folder.

magento_root/vendor/mirasvit/module-feed/src/Feed/Setup/data/mapping

This allows you to use custom category mappings for different platforms.

Starting from version 1.7.1, if the required mapping file is not available, you can create your own custom mapping manually.

Note

If you're working in a cloud-based environment (e.g., Adobe Commerce Cloud), modifying files under the vendor directory is typically not allowed or supported.

How to use category mapping in feeds​

  • For CSV feeds

    • Select the attribute Category mapping: Name from the drop-down list.

  • For XML feeds

    • Use the pattern: 
      {{ product.mapping:mapping_id }}
      Example: 
      {{ product.mapping:1 }}
      Here, 1 is the Category mapping ID assigned to your mapping.