Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4    Statistic  


Launches the file.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Files 2.7 Yes Yes Yes No No
MBS( "Files.LaunchFile"; Path { ; NewInstance } )   More


Parameter Description Example value
Path Native path to the item to reveal. "/Users/cs/Desktop/Notes.rtf"
NewInstance Optional
Available in MBS FileMaker Plugin 7.2 or newer.
Whether to launch new app instance on Mac.
Default is 0.


Returns "OK" or error.


Launches the file.
The OS will lookup what application is associated with the file type and launch the application asking it to open the document.

See also Files.Launch if you need to pass application and document.
If you launch a folder path, the folder will open in Finder/Explorer.

Please use Files.LaunchFile to open a file and Files.Launch to open a file in a specific application.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.


Shows a folder in Finder on Mac:

MBS( "Files.LaunchFile"; "/Users" )

Write container to temp file and launch:

# get temp folder
Set Variable [$TempFolder; Value:MBS( "Folders.SystemTemporary" )]
# and file name from container
Set Variable [$name; Value:MBS( "Path.LastPathComponent"; test::myContainer )]
# add name to folder path
Set Variable [$TempPath; Value:MBS( "Path.AddPathComponent"; $TempFolder; $name )]
# now write temp file
Set Variable [$r; Value:MBS( "Files.WriteFile"; test::myContainer; $TempPath)]
# and launch file
Set Variable [$r; Value:MBS( "Files.LaunchFile"; $TempPath)]

Launch new copy of same app:

MBS("Files.LaunchFile"; "/Applications/FileMaker Pro 15 Advanced/FileMaker Pro"; 1)

See also

Example Databases

Blog Entries

Release notes

Created 18th August 2014, last changed 11st July 2017

Files.Launch   -   Files.List

Feedback: Report problem or ask question.

MBS Xojo blog