## Add to List

This function adds an item to the start or end of a list or inserts it at a specified index in a list. The list can be in a field or named variable.

When inserting at a specified index, there are no invalid indexes. An index value less or equal to 0 is treated the same as adding to the start of the list. An index value greater or equal to the number of items in the list is treated the same as adding to the end of the list.

The delimiter used to separate the item being added from the destination cannot be empty. If the delimiter resolves to be empty when the action is executed, a default (\~) will be assumed.

By default, when adding to a list in a named variable, only one item is added regardless of the number of files being processed. You can override this behaviour and force all files to be enumerated by specifying the Enumerate all files option. This only has an effect when executing stepwise.

You can optionally specify that an item should only be added if it is not empty.

You can also specify that an item should only be added to the list if it is not already present anywhere in the list. This match can be case insensitive.

All text fields may contain any of the escape sequences described in Escape Sequences.

Note that where running stepwise all text fields, with the exception of the data field, are only processed for escape characters once based on the contents of the first file.