Choice library and CSV files

Updated November 10, 2026

Reuse a list of choices in other forms, or build one in a spreadsheet. All four buttons are under Choice library at the bottom of the field’s KodaChoices section.

Save a list to the library

  1. Set up the field’s choices, with their pictures, colors, icons and extras.
  2. Click Save to library, enter a name for the list and click Save.

The list keeps each choice’s label, value, price and every KodaChoices setting (picture, hover picture, swatch colors, pattern, icon, sub-label, description, badge, unavailable, score, limit, group heading and rules).

Use a saved list

  1. Click the field and open its KodaChoices section.
  2. Click Use a saved list, pick the list and click Replace this field’s choices.
  3. Confirm, then click Save Form.

The field’s current choices are replaced. The list is copied into the field, so later changes to the list don’t change fields that already used it, and the other way round.

Choice rules point at fields by their ID. If you use a list with rules in another form, check each rule’s field in Label extras.

Manage saved lists

Lists are site-wide. Rename, delete or export them under Form Settings → KodaChoices → Choice library.

The choice library panel
The Choice library panel in Form Settings → KodaChoices.
  • Rename: type the new name and click Rename.
  • Export CSV: downloads the list as a CSV file.
  • Delete: removes the list. Fields that used it keep their choices.

Import choices from a CSV file

  1. Click Import CSV in the field’s KodaChoices section and choose a .csv file.
  2. Confirm that the field’s choices should be replaced, then click Save Form.

The first row can be a header naming the columns, in any order. Without one, the columns are read in this order:

ColumnWhat it holdsAlso accepted as a header
labelThe choice’s label (required)text, choice, name
valueThe value saved in entries. Empty uses the label.
pricePrice, for product fields
scoreA number for kc_scorepoints
imageA picture: its full URL, or its Media Library IDpicture, photo
subSub-labelsublabel, sub-label, subtitle
descriptionDescription shown on hoverdesc
badgeBadge text
limitLimit for this choice (a whole number)stock
groupGroup heading before this choiceheading
colorSwatch color, as a hex code such as #1e3a8acolour, swatch
color2Second colorcolour2, second color
iconA Font Awesome icon name, such as leaf or fa-regular fa-star

Commas or semicolons both work as separators, and cells can be in quotes. Rows with no label are skipped.

Click Export CSV on a field that’s already set up to get a file in exactly the right format, then edit it in your spreadsheet program.

Export a field’s choices

Export CSV downloads the field’s choices with the columns above. Badge looks, hover pictures, patterns, icon colors and rules aren’t in CSV files; use the choice library to keep those.

Was this page helpful?
Scroll to top