Creating Jobs by Importing a Jobs CSV File

🚧

This is an all-or-nothing import.
You cannot import any job as long as at least one job has validation errors.

What You Can Do

• Download a ready-to-use CSV template
• Fill job data in bulk
• Upload and validate before import
• Create jobs for a selected pipeline step

Before You Start

1. Open Jobs and choose the correct pipeline and step.
2. Download the CSV template from the import panel.
3. Keep required headers exactly as provided in the template.

Import Steps

1. Open Import Jobs From CSV.
2. Click Download CSV Template.
3. Fill the CSV file with your job data or use it as example to generate yours.
4. Upload the CSV file.
5. Review CSV Preview and fix any validation errors.
6. Click Confirm and Create Jobs.

CSV Rules

• Read carefully the CSV Import Instructions that are autogenerated. It contains important information about the required and optional columns/data.
• Header matching is case-insensitive.
• Required columns must be present.
• Column order does not matter.
• You can add multiple tag and billing_tag columns.
• Each tag cell must use this format: TagName=TagValue
• Only one tag pair is allowed per tag column.

Validation Behavior

• If the file has errors, they are shown in the Validation Errors panel.
• You must fix errors and upload again before creating jobs.
• If there are no validation issues, the file is ready for import.

Import Result Behavior

• Success:
  • A success toast is shown confirming the number of jobs imported.
  • The import sidebar closes.
  • Jobs list refreshes.
• Failure:
  • An error toast is shown
  • Validation errors are shown
  • No jobs are created

Common Errors

• No jobs found to import
  • Cause: no valid rows after parsing or empty file.
• CSV parsing errors/validation:
  • Cause: wrong data type (using text instead of numbers), duplicated tags, inconsistent column numbers, invalid column headers, date & time format, start date is after end date or identical.
• Failed to create jobs
  • Cause: API rejected the payload or server error.

Best Practices

1. Always start from the downloaded template.
2. Test with a small CSV first.
3. Keep values consistent across rows.
4. Avoid extra spaces in headers and key values.