Skip to content

System dictionaries ​

Pro

System dictionaries are lists VX maintains for you. Link one to a choice field instead of typing 250 countries by hand. They're read-only, and they have no Source tab.

DictionaryWhat's storedLabel shown
CountriesThe two-letter ISO code (PT)The country name (Portugal)
CurrenciesThe ISO code (EUR)Name and code (Euro (EUR))
Length (metric / imperial)A unit code (km, mi)Name and symbol (Kilometer (km))
Area (metric / imperial)A unit codeName and symbol
Volume (metric / imperial)A unit codeName and symbol
Weight (metric / imperial)A unit codeName and symbol

Because the stored value is a standard code, it stays valid if a label's wording changes, and other systems can read it directly.

To use one, set a choice field's choices source to the system dictionary, the same way as a dictionary of your own.

Technical details for LLMs
  • Keys: countries, currencies, length_metric, length_imperial, area_metric, area_imperial, volume_metric, volume_imperial, weight_metric, weight_imperial.
  • Entry attributes beyond value/label: countries add name, alpha2, alpha3, calling_code, region, flag (emoji); units add name, symbol.
  • Link with choices_source: "system_dictionary", system_dictionary: "<key>". Read entries with vx-framework/get-dictionary-entries.
  • Register your own provider: see Extending VX.

Documentation for the VX Framework.