CSV Import for Configurator: Benefits and Requirements

Context

Importing recipes via a CSV file is the fastest and most reliable way to manage large batches in the Configurator. Whether you're creating multiple new recipes or updating existing ones, this method can help reduce errors and save time.

You can import:

CSV files (note: pallet pattern is not supported)
URLs from existing Configurator simulations
XML or TXT files from external packaging software like Cape Pack and TOPS

To successfully import CSV files into your project, make sure that they meet certain formatting requirements described in this article.

Note: This feature is currently behind a feature flag "?ff_import_csv&ff_export_csv" and not available by default.

Video demo (5:24)

Link: https://drive.google.com/file/d/1eAj9r3Lqzl1ljhJHC-ZbCUWqQFvlgaV-/view?usp=drive_link

Information

1. How to Prepare Your CSV File

Before importing, ensure your file matches the correct format.

To retrieve the correct headers:

Option 1: Export headers only
- Go to your recipe
- Click EXPORT
- Select Template
Option 2: Export a full recipe as a reference
- Add one default recipe line
- Export as CSV to get headers plus example values

Required Columns

To create new recipes, your CSV must include:
- Unit System
- Box Side
- Box Front
- Box Height
- Box Weight
To update existing recipes, your CSV must include:
- Unique identifier