Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1    Statistic  


Queries list of paths in folder.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Files 4.1 Yes Yes Yes Yes Yes

MBS( "Files.ListRecursive"; Path { ; filter; Timeout } )


Parameter Description Example value
Path Native path to the directory. "C:\Test\"
filter Optional
Optional, limits what is returned. Default is 0 to report all files. Pass a combination of 1 for showing only files, 2 for showing only directories and 4 for showing only visible files. Add 16 to include package file content on Mac. Add 32 to treat packages as files.
In v7.3 you can add 64 to not list content of invisible directories.
Timeout Optional
the timeout in seconds. Default is 5.


Returns list of files separated by return.


Queries list of paths in folder.
This function is recursive and will look in all subfolders. Due to very large file systems you can pass a timeout. Default is 5 seconds. FileMaker will not respond to user input while the query runs.
The list of names is separated by new line character.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.
You can decide on Mac on whether files inside a package (e.g. application) are listed or not. By default we ignore those files, but you can include package content with adding 16 to the filter parameter.

See also Files.List.


Queries files in Users folder on Mac:

$files = MBS("Files.List"; "/Users")

Queries visible files in windows folder:

$files = MBS("Files.List"; "c:\Windows\"; 5)

Queries visible files in windows folder, limit for 10 seconds:

$files = MBS("Files.List"; "c:\Windows\"; 5; 10)

List only visible files in visible directories:

MBS( "Files.ListRecursive"; "/Users/shared"; 64+4)

See also

Example Databases

Files.List   -   Files.ListVolumes

Feedback: Report problem or ask question.

MBS FileMaker Plugins