Job Mode Setup
Configure Akeneo export jobs for large catalogs with more than 50,000 products.
Advanced Feature: Job Mode is designed for large catalogs. For catalogs under 50,000 products, we recommend using the default Batch Mode which requires no additional setup.
Important: Job Mode only applies to full exports. Incremental exports always use the REST API (Batch Mode), regardless of your configuration. This means filters and scope configured in SyncPIM will be applied during incremental exports.
When to Use Job Mode
Job Mode uses Akeneo's native export jobs to generate CSV files, which SyncPIM then processes. This approach is more efficient for very large catalogs.
Batch Mode (Default)
- ✓Best for < 50,000 products
- ✓No setup required in Akeneo
- ✓Filters configured in SyncPIM
- ✓Real-time streaming via REST API
- ✓Used for both full & incremental exports
Job Mode (Advanced)
- ★Best for > 50,000 products
- ★Requires Akeneo job setup
- ★Filters configured in Akeneo
- ★CSV-based bulk processing
- ℹFull exports only — Incremental uses REST API
Prerequisites
Create Product Model Export Job
This job exports configurable products (products with variants).
In Akeneo, go to Exports (Imports/Exports menu)
Click Create
Select job type: Product model export in CSV
Set the job code to:
syncpim_product_model_export💡 Tip: You can use a custom job code, but you'll need to configure it in SyncPIM's Advanced settings.
Configure Product Model Job
Configure the job settings in the Content and Global settings tabs.
Global Settings
ecommerce)Content Tab (Filters)
⚠️ Important: In Job Mode, filters are configured here in Akeneo, not in SyncPIM. The SyncPIM filter configuration is ignored.
Create Product Export Job
This job exports simple products and variants.
Go back to Exports and click Create
Select job type: Product export in CSV
Set the job code to:
syncpim_product_exportConfigure Product Job
Apply the same settings as the Product Model job for consistency.
Recommended Settings
- ✓Same channel as Product Model job
- ✓Same locales as Product Model job
- ✓Same filters (families, status) as Product Model job
Enable Job Mode in SyncPIM
Now configure SyncPIM to use your export jobs.
Go to your configuration in SyncPIM
Navigate to the Advanced tab
In Export Mode, select Job Mode
If using custom job codes, expand Job Configuration and enter your codes
Product Models Job Code
syncpim_product_model_exportProducts Job Code
syncpim_product_exportTest Your Export
Run a test export to verify everything works correctly.
Save your configuration
Click Run Full Export
Watch the logs - you should see job execution messages
Expected log messages:
[INFO] Starting export in JOB mode
[INFO] Launching Akeneo job: syncpim_product_model_export
[INFO] Job started, execution ID: 12345
[INFO] Waiting for job completion...
[INFO] Job completed, downloading CSV...
[INFO] Processing 1,234 product models
[INFO] Launching Akeneo job: syncpim_product_export
...Job Mode Limitations
- ⚠️Filters: Must be configured in Akeneo job, not in SyncPIM
- ⚠️Scope/Channel: Must be set in Akeneo job configuration
- ⚠️Variant Filters: Not supported in Job Mode
- ⚠️Real-time progress: Limited - progress updates only after each job completes
Troubleshooting
Job not found error
Verify the job code matches exactly. Check in Akeneo under Exports → click your job → the code is shown in the URL and details.
Permission denied
Ensure your API connection has permission to execute export jobs. In Akeneo: System → Roles → check "Execute export jobs" permission.
Job stuck or timeout
Large exports can take time. Check the job status in Akeneo: System → Process Tracker. If stuck, try reducing filters or splitting the export.
Job Mode Ready! Your large catalog export is now configured. Exports will use Akeneo's native job system for optimal performance.
Next Steps
ℹ️ Need Help? Check our Export Failures troubleshooting guide.