Setup Configurable Products in KatanaPIM
Looking for Magento 2 KatanaPIM integration? View the full Magento 2 KatanaPIM integration page to explore features, configuration options, and pricing.
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
For a complete overview of features and configuration options, see Magento 2 KatanaPIM integration.