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


Sets the Finder label.

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


Parameter Description Example
Path The native path to the file. "/Users/cs/Desktop/test.txt"
Label The new label number.
0 = no label
1 to 7 give different colors.


Returns OK or error.


Sets the Finder label.
Value is from 0 to 7. Zero is no label. Numbers 1 to 7 are mapped to colors and tags.
Currently the list is 1 = gray, 2 = green, 3 = purple, 4 = blue, 5 = yellow, 6 = red, 7 = orange.
Please use Files.SetTagNames to set tag names if needed.

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.


Set color to green:

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

See also

Blog Entries

This function checks for a license.

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

Files.SetFileExtensionHidden - Files.SetHidden