# Fill Lists

This function's purpose is to fill the lists associated with the supplied field content. Fields can be specified in a table or in a named variable.

When the fields are specified in a named variable, the content of the unescaped named variable is interpreted as a list of symbolic field names. The list can be delimited by default list delimiters (\~), newline characters (\n) and commas. Items which do not represent field names are ignored. The list of valid fields are processed exactly as if they were specified in the table. This effectively provides a means of specifying which fields are to be processed at runtime.

If a field contains multiple items separated by the Multi Value Delimiter, each value will be processed individually. If a specified field is not associated with a list, nothing will be modified. Unique values are added to the appropriate lists.

Note that lists can be filled for built in items and for custom fields. All custom fields are listed. The determination is made at runtime as to whether a custom field is associated with a list.

This function may be used while batch processing to populate your lists.

This statement's behaviour can be modified by the Advanced List Settings.

Lists are case and diacritic insensitive and ignore leading articles found in the Natural Sort Exception Set.