# Set Action Runtime Setting

You may want to save persistent settings for some of your actions. Yate provides a special access mechanism to read and write these settings. Action Runtime Settings are described in Action Runtime Settings.

The set being manipulated is always the set mapped via the Map Action Runtime Settings statement.

This statement is used to set the value of a setting. Note that # characters are removed from names at runtime. If a setting is assigned an empty value, the setting will be removed and is subsequently treated as an empty value. You cannot set multi-line values. Values will be truncated at the first occurrence of any newline character.

If the setting is named # and the value is empty, the entire set will be removed.

There is one possible situation where you might want to store empty values. If you are using an Extract Preference Set statement to save a set to named variables, you might want the items with empty values to be present so that the empty named variables are cleared. You can allow the storage of an empty setting by prefixing the name with a # character. Note that the # character is not actually part of the name.

The writing of an Action Runtime Setting is far less efficient than storing a Named Variable. While Action Runtime Settings can be treated as Named Variables, it is not recommended that you do so.

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

Regardless of the current execution mode, this statement is only executed once for any number of selected files.