Setup Configurable Products in KatanaPIM
Manage imported products in the KatanaPIM Connect Products grid. View PIM data, create Magento products, and control synchronization.
Accessing the Grid
Navigate to Katana PIM → Products in the admin menu.
Grid Columns
| Column | Description |
|---|---|
| ID | KatanaPIM product ID |
| Name | Product name from PIM |
| SKU | Product SKU |
| Katana Type | Product type in PIM (simple, variant, etc.) |
| Type | Magento product type (simple, configurable) |
| Attribute Set | Assigned Magento attribute set |
| Magento Visibility | Current visibility in Magento |
| Magento Websites | Assigned websites |
| Magento Status | Enabled/Disabled in Magento |
| Skipped | Whether product is excluded from sync |
| Deleted | Whether product was deleted in PIM |
| Updated | Last update timestamp |
| Needs Update | Whether PIM data differs from Magento |
Additional columns (hidden by default): URL Key, Magento Product ID, Parent ID, GrandParent ID, Created, Magento Updated.
How Products Enter the Grid
Products appear in this grid through API Import from KatanaPIM:
- Full Sync — Imports all products from PIM
- Incremental Sync — Imports only changed products
This can be triggered via CLI commands (katana:import:full, katana:import:incremental) or the toolbar buttons in the grid.
What happens next depends on your configuration:
- Auto create enabled — Sync automatically creates/updates Magento products after importing to the grid
- Auto create disabled — Products 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 products.
Grid Actions
Toolbar Buttons
| Button | Description |
|---|---|
| Sync Incremental | Run incremental update from PIM |
| Sync Full | Run full update from PIM |
| Reload Data | Refresh the grid data |
Mass Actions
| Action | Description |
|---|---|
| Update/Create Magento Products | Create or update Magento products for selected items |
| Update/Create Magento Products (force) | Force update even if hash matches |
| Delete Magento Products | Delete the linked Magento products |
| Delete Records | Remove records from the KatanaPIM table |
| Mark Products as Skipped | Exclude from automatic sync |
| Unmark Products as Skipped | Include in automatic sync |
Row Actions
Click the Actions column for individual product options:
- View/Edit in Magento (if product exists)
- View product data details
- Inspect API — View raw API response from KatanaPIM
Inspect API Modal (available from v3.7.0)
The Inspect API action opens a modal showing the raw JSON response from the KatanaPIM API for that product. This is useful for:
- Debugging mapping issues — See exactly what data is coming from PIM
- Verifying field values — Check if expected data exists in the API response
- Troubleshooting sync problems — Compare API data with what's imported
Understanding "Needs Update"
The Needs Update column indicates sync status:
| Status | Meaning | Action |
|---|---|---|
| Yes (highlighted) | PIM data differs from Magento | Run sync or mass action to update |
| No | Product is in sync | No action needed |
The module compares data hashes between PIM and Magento to detect changes.
Working with Skipped Products
Mark products as Skipped to exclude them from automatic synchronization:
When to skip:
- Products not ready for Magento
- Test products in PIM
- Products for different channels
How to skip:
- Select products using checkboxes
- Choose Mark Products as Skipped from mass actions
- Confirm the action
Skipped products won't be created/updated during cron runs.
Creating Magento Products
Manual Creation
- Select products in the grid
- Choose Update/Create Magento Products mass action
- Wait for processing to complete
- Check Sync Log for results
Automatic Creation
Enable in Katana PIM → Automation:
- Set Auto create new products to Yes
- Configure cron frequency
New products will be created automatically during sync.
Force Update
Use Update/Create Magento Products (force) when:
- You need to overwrite Magento changes
- Hash comparison isn't detecting changes
- Troubleshooting sync issues
Filtering Products
Use the filter row to find specific products:
- Text search - Search across name, SKU
- Type filter - Filter by Katana type or Magento type
- Status filter - Filter by Magento status
- Skipped filter - Show only skipped/non-skipped
- Needs Update filter - Show only items needing sync
- Date range - Filter by update date
Workflow Example
First-time import:
- Run Sync Full to import all products
- Review products in the grid
- Mark unwanted products as Skipped
- Select products to create
- Use Update/Create Magento Products
- Verify in Magento catalog
Ongoing maintenance:
- Cron runs Incremental Sync automatically
- Changed products appear with Needs Update = Yes
- Auto-create handles new products (if enabled)
- Existing products are updated automatically
Need More Help?
Documentation:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team