Fields

Each field maps one application property.

type ImporterField = {
  key: string;
  label: string;
  type: "string" | "number" | "date" | "email" | "enum" | "boolean" | "url";
  required?: boolean;
  unique?: boolean; // when true, values must be unique across rows in the file
  enumValues?: string[]; // required for meaningful enum validation
  aliases?: string[]; // extra header names for auto-map
};

Use aliases when customers routinely export headers that do not match your key or label (for example E-mail or Email Address for email).

Use duplicateKey on the component (or hosted config) to detect repeated values across rows for one field. Use field-level unique when several fields must be unique independently.

Locale helpers on <Importer />: dateOrder (MDY | DMY), numberLocale (us | eu | auto), and dir (ltr | rtl).

Related: Validation · Duplicates · Column mapping