Import and export

Avvyr's import and export system lets you move product data in and out of your catalog in bulk. Both processes run as asynchronous jobs — you start a job, monitor its progress, and review the results when it completes.

Import

Import jobs let you bring product data into Avvyr from external files.

Creating an import job

1. Go to Settings → Import & Export in the sidebar.
2. Navigate to the Import tab.
3. Click to create a new import job.
4. Upload your file — the system accepts files via multipart upload.
5. Configure entity-specific import options.
6. Start the import.

Monitoring import progress

Once an import job is running:

• The job list shows the current status and progress.
• Click on a job to see detailed statistics: processed rows, successful imports, errors.
• If errors occurred, you can inspect individual error details to understand what went wrong.

Import job statuses

Export

Export jobs let you extract product data from Avvyr for external use, reporting, or backup.

Creating an export job

1. Go to Settings → Import & Export in the sidebar.
2. Navigate to the Export tab.
3. Click Create to start a new export job.
4. Configure filter criteria to select which products to export.
5. Set up schema mapping to control which fields are included.
6. Start the export.

You can also trigger an export directly from the product list page using the Export button.

Export configuration

• Filter criteria — Define which products to include based on status, categories, or other attributes.
• Schema mapping — Choose which product fields and attributes to include in the export file.

Downloading export results

Once an export job completes:

1. Open the export job detail page.
2. Download the generated file.

Scheduled jobs

Both import and export support scheduled execution, allowing you to set up recurring data synchronization without manual intervention. Configure schedules through the import/export service endpoints.

Error handling

When import or export jobs encounter issues:

• Partial success — The job completes but some rows had errors. Review the error details to identify and fix the problematic data.
• Validation errors — Fields that don't match expected formats or required values are flagged individually.
• Fatal errors — If the job fails entirely, the error message explains the root cause.

For import jobs, you can fix the source data and re-run the import rather than trying to manually correct each error in the product editor.

Best practices

• Start with a small test file — Before importing a large dataset, test with a small sample to verify your column mappings and data format are correct.
• Review error reports — After every import, check the job statistics for errors. Fixing data issues at the source prevents recurring problems.
• Use exports for backups — Regularly export your product catalog as a backup before making large changes.
• Schedule recurring syncs — If you receive product data from suppliers on a regular basis, set up scheduled imports to automate the process.
• Filter exports thoughtfully — Only export the data you need. Large exports with all fields take longer to process and generate larger files.