Attribute Mapping for Magento 2

How to map KatanaPIM attributes to Magento attributes in KatanaPIM Connect. Proper attribute mapping is essential for correct product data synchronization.

Overview

Attribute mapping connects PIM attributes to Magento attributes. There are two levels of mapping:

1. Core field mapping - In configuration (Name, Description, GTIN, etc.)
2. Custom attribute mapping - In the Attributes grid (inline editing)

Core Field Mapping

Configure in Stores → Configuration → Katana PIM → Product Data → Attributes.

These map KatanaPIM attributes to Magento's built-in product fields:

Select the corresponding KatanaPIM attribute from the dropdown for each field.

Custom Attribute Mapping

For all other attributes, use the Attributes grid at Katana PIM → Attributes.

Step 1: Import Attributes

Step 2: Map Attributes Using Inline Edit

Step 3: Set Configurable Attributes

Step 4: Skip Unwanted Attributes

Attribute Types

The module handles different PIM attribute types:

When creating new Magento attributes, the correct type is determined automatically.

Auto-Created Attributes

When you select "Create New" in the mapping, the module creates a new Magento attribute:

• Attribute code: katanapim_ + original code
• Label: From PIM attribute name
• Type: Based on PIM attribute type
• Scope: Global
• Visible on frontend: No (can be changed later)

You can modify these attributes in Stores → Attributes → Product after creation.

Mapping to Existing Attributes

To map to an existing Magento attribute:

1. The attribute must exist in Magento first
2. Select it from the dropdown in the Attributes grid
3. Ensure attribute types are compatible

Common existing attributes:

• brand - For manufacturer/brand
• color - For color variants
• size - For size variants
• weight - For shipping weight
• manufacturer - For manufacturer name

Attribute Sets

Imported products use the Default attribute set. To use custom attribute sets:

1. Create attribute sets in Stores → Attribute Sets
2. Add your mapped attributes to the sets
3. Products will inherit attributes from their assigned set

Best Practices

Do's:

• ✅ Map all essential attributes before first product sync
• ✅ Set "Is Configurable" for variant attributes early
• ✅ Use existing Magento attributes when possible
• ✅ Skip attributes you don't need to reduce sync time
• ✅ Review attribute mapping after PIM changes

Don'ts:

• ❌ Change mappings after products are created (causes data issues)
• ❌ Map multiple PIM attributes to the same Magento attribute
• ❌ Forget to set configurable flag for variant attributes
• ❌ Create duplicate Magento attributes

Troubleshooting Mapping Issues

Attribute not showing in dropdown

Attribute values not syncing

Configurable products not creating

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team