Skip to main content

Populating Field Options
LitePro
Improved in 5.0+, 5.17+

All multi-option field types (such as Dropdown, Checkboxes, etc) can have their option labels and values automatically populated with Craft Elements or Pre-defined list options. This allows you to quickly build forms by having fields auto-generated.

Need more control over populating field options dynamically at template level, such as from a Craft Entry or some other Twig code in your template? Check out how to populate field options at template level.

​Applicable Field Types

The following field types can be auto-populated:

​Available Options
LitePro

The following Freeform Predefined Options and Craft Elements can be fed to the above field types:

Need to build your own custom Predefined Options list? Check out the guide.

​Months

  • All 12 months of the year.
  • Option Label and Option Value choices:
    • Full, e.g. September
    • Full (translated), e.g. SeptembreNew in 5.14.12+
    • Abbreviated (Capitalized 3 letters), e.g. Sep
    • Single Number, e.g. 9
    • 2-digit Number, e.g. 09

​Days

  • List of days 1 to 31.
  • Option Label and Option Value choices:
    • Single Number, e.g. 3
    • 2-digit Number, e.g. 03

​Days of Week

  • List of all days of week.
  • Option Label and Option Value choices:
    • Full, e.g. Thursday
    • Full (translated), e.g. DonderdagNew in 5.14.12+
    • Abbreviated (Capitalized 3 letters), e.g. Thu
    • Single Number, e.g. 4

​TimezonesNew in 5.15.17+

  • All world timezones
  • Option Label and Option Value choices:
    • UTC Label, e.g. (UTC-04:00) New York
    • Identifier, e.g. America/New_York

​Time IntervalsNew in 5.17+

Generates a list of times using these settings:

  • Start Time: The first time, entered in 24-hour HH:MM format.
  • End Time: The final boundary, on the same day and at or after the start time.
  • Interval: Spacing of 15, 30, or 60 minutes.
  • Time Label Format: Display times using 12-hour or 24-hour notation.

For example, 09:00 to 10:00 at 30-minute intervals produces 09:00, 09:30, and 10:00. The end time is included when it falls on an interval.

Stored values always use 24-hour HH:MM format, regardless of the label format. These options provide a time list; they do not check availability or prevent duplicate bookings.

​Convert to Custom OptionsNew in 5.0+

Sometimes you need a little more control over the populated data generated by the Element or Predefined options. You can click the Convert to Custom Options button at any time to have the generated option data converted to Custom options that can then have its options edited, removed, added, renamed, and reordered.

There are potentially negative implications with using this feature:

  • Your options data can become out of sync when new elements (e.g. Entries) are added after the fact.
  • If you apply this when there are already existing submissions, renaming option values will orphan submissions relying on the old value name.
  • Be very careful if you attempt to redo this process (e.g. changing back to Element source and grabbing a fresh list of Craft Entries, then converting back to Custom). If any existing submissions are relying on old or modified option values, they can become orphaned in the process.
Page Feedback