The directory field is essentially the same as the file field except it the selection is limited to directories only, not single files.
The directory supports the following two special attributes for the <spec> element:
Specifies whether or not the selected path must be an existing directory.
true, false default: true
Specifies whether or not the selected directory should be created if it does not exist. (requires mustExist=false)
true, false default: false
The directory supports a <description> element that can be used to provide information about the purpose of the directory field.
See Fields documentation for more detail.
Messages for the directory field can be customized by creating a custom lang pack and overriding the following values (attribute values wrapped for readability):
Note: Mixing directory fields with other fields that have text in front of them can lead to formatting (layout) issues. Placing these types of elements on different panels can provide a much better user experience.