How CSV form import works

You can upload a CSV to build or replace your form’s fields at any time. Click Download template to get a starter file. Edit it in your spreadsheet of choice (Excel, Numbers, Google Sheets, LibreOffice — any of them, as long as you save as comma-separated CSV). Then click Upload CSV and pick the saved file. Your form is rebuilt in one shot.

Uploading replaces all existing fields. This makes corrections easy: upload, review the result in the builder, adjust your CSV, and upload again.

Columns

The CSV has 27 columns, in this order:

  • Field — the field type. One of: text, email, phone, number, textarea, dropdown, checkbox, radio, date, divider, subtitle, description.
  • Label — the question prompt the respondent sees (in English). Required for all field types except divider. For subtitle and description, this is the heading or paragraph text.
  • FieldName — the JSON key your data will be stored under (e.g., email_address). Optional. If you leave it blank, we’ll auto-fill question1, question2, etc. We’ll lowercase, replace spaces and special characters with underscores, and rename duplicates by adding _2, _3, etc.
  • Required — true, false, yes, no, y, n, 1, 0, or blank (treated as false). Ignored for non-input fields.
  • Placeholder — optional hint text shown inside the input. Only applies to single-line, multi-line, number, and date fields. Ignored for choice fields, dividers, subtitles, and descriptions.
  • FrenchLabel — the French version of Label. Leave blank to keep the field English-only.
  • FrenchPlaceholder — French version of Placeholder.
  • Option1–Option10 — choices for dropdown, checkbox, radio, and ranking fields. At least one is required for choice fields; ranking requires at least two. You don’t need to fill every slot — if Option7–Option10 are blank, only the first 6 are created. Empty options between filled ones are skipped (Option1=Yes, Option2=, Option3=No becomes the choices [Yes, No]).
  • FrenchOption1–FrenchOption10 — French versions of the options, paired by index. Leave a slot blank to keep that option English-only.

Field types

  • text — single-line input.
  • email — email-validated input.
  • phone — telephone-formatted input.
  • number — numeric input.
  • textarea — multi-line input.
  • dropdown — single-select from a list.
  • checkbox — multi-select from a list.
  • radio — single-select displayed as radio buttons.
  • ranking — drag-and-drop priority ranking. Uses the same Option1–Option10 columns as choice fields. Requires at least 2 options.
  • date — date picker.
  • divider — a horizontal line. Only the Field column matters.
  • subtitle — section heading. The Label column is the heading text. FrenchLabel provides the French version.
  • description — paragraph of explanatory text. Same column rules as subtitle.

Common questions

I have more than 10 options for a dropdown. Import what fits in Option1–Option10, then add the rest in the builder.

Excel saved my file with semicolons instead of commas. Some French Excel locales default to semicolon-separated CSV. Use File → Save As → CSV (Comma delimited) to force commas.

My French translation is missing for one option. That’s fine — leave the FrenchOption slot blank. The option will be displayed in English on the live form for both languages.

I uploaded the wrong file / I want to change the form. Just upload the corrected CSV again — each upload replaces all fields.

← Back to dashboard