Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Queries the label of the file or folder.

Component Version macOS Windows Linux Server iOS SDK
Files 6.2 ✅ Yes ❌ No ❌ No ✅ Yes, on macOS ❌ No
MBS( "Files.GetFinderLabel"; Path )   More


Parameter Description Example
Path The native path to the file. "/Users/cs/Desktop/test.txt"


Returns number or error.


Queries the label of the file or folder.
Value is 0 for no label or 1 to 7 for different colors.
Please use Files.GetTagNames to query tag names.

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.


Query color:

MBS("Files.GetFinderLabel"; "/Users/cs/Desktop/test.rtf")

See also

Blog Entries

This function checks for a license.

Created 17th May 2016, last changed 17th May 2016

Files.GetComment - Files.GetNodeID