Configure KatanaPIM in Magento 2
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