Configure KatanaPIM in Magento 2
Looking for Magento 2 KatanaPIM integration? View the full Magento 2 KatanaPIM integration page to explore features, configuration options, and pricing.
Manage imported categories in the KatanaPIM Connect Categories grid. View PIM category structure and create Magento categories.
Accessing the Grid
Navigate to Katana PIM → Categories in the admin menu.
Grid Columns
| Column | Description |
|---|---|
| ID | Internal entity ID |
| Pim ID | KatanaPIM category ID |
| Name | Category name from PIM |
| URL | Category URL key |
| Magento ID | Linked Magento category ID |
| Level | Category depth level |
| Path | Full category path |
| Skipped | Whether category is excluded from sync |
| Is Deleted | Whether category was deleted in PIM |
| Has Error | Whether an error occurred during sync |
| Error | Error message if applicable |
| Updated | Last update timestamp |
How Categories Enter the Grid
Categories appear in this grid through API Import from KatanaPIM:
- Full Sync — Imports all categories from PIM
- Incremental Sync — Imports only changed categories
This can be triggered via CLI commands (katana:import:full --categories) or the toolbar buttons in the grid.
What happens next depends on your configuration:
- Auto create enabled — Sync automatically creates/updates Magento categories after importing to the grid
- Auto create disabled — Categories stay in the grid as intermediate data; use mass actions to manually create them in Magento
Configure this at Stores → Configuration → KatanaPIM → Automation → Auto create new categories.
Categories maintain their hierarchy (parent/child relationships) from PIM.
Grid Actions
Toolbar Buttons
| Button | Description |
|---|---|
| Reload Data | Refresh categories from database |
| Create | Manually trigger category creation |
Mass Actions
| Action | Description |
|---|---|
| Mark Categories as Skipped | Exclude from automatic sync |
| Unmark Categories as Skipped | Include in automatic sync |
| Update/Create Magento Category | Create or update Magento categories |
| Delete Magento Categories | Delete linked Magento categories |
| Delete Records | Remove from KatanaPIM table |
Creating Magento Categories
Manual Creation
- Select categories in the grid
- Choose Update/Create Magento Category
- Categories are created with proper hierarchy
- Check for errors in the grid
Automatic Creation
Enable in Automation settings:
- Set Auto create new categories to Yes
- Categories are created during sync
Category Linking
If If name exists link category is enabled:
- Module looks for existing Magento categories with same name
- Categories at matching depth level are automatically linked
- Prevents duplicate category creation
Error Handling
The Has Error and Error columns show sync issues:
| Error Type | Solution |
|---|---|
| Parent not found | Create parent category first |
| Duplicate URL key | Modify URL in PIM or Magento |
| Invalid characters | Clean category name in PIM |
Resolve errors and retry the sync.
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team
For a complete overview of features and configuration options, see Magento 2 KatanaPIM integration.