Open Files Dialog

Category: User Interface

Opens a file picker that allows one or more files to be selected and returns their paths as a list. Use `types` to limit the file extensions shown by the picker, for example `["srt"]` for subtitle files. Use `initialDomain` to control which location the dialog opens in first. With `cancelBehavior=STOP`, cancelling aborts the script immediately. With `cancelBehavior=EMPTY`, cancelling returns an empty list instead.

Inputs

Input	Required	Value Kind	Types	Enum Values
types	no	expression	array	—
cancelBehavior	no	enum	enum-string	STOP, EMPTY
initialDomain	no	enum	enum-string	DEFAULT, USER_DESKTOP, USER_DOCUMENTS, USER_PICTURES, USER_VIDEOS, USER_MUSIC, USER_DOWNLOADS, USER_HOME, TEMP, APP_LOCAL_DATA, APP_LOCAL_LIBRARY, APP_LOCAL_CACHE, APP_LOCAL_SHARED, APP_LOCAL_TEMPORARY, APP_ROAMING_DATA, APP_ROAMING_LIBRARY

Notes

No additional notes are available yet.

See Also

• Building Prompt Dialogs: Explains how UI Prompt Field and UI Prompt Form work together to build custom dialogs.
• Open File Dialog: Opens a file picker and returns the selected file path as a string.
• UI Prompt Field: Creates one field definition that can later be shown inside a prompt dialog.