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


Queries names of the tags assigned to the file/folder.

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


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


Returns list or error.


Queries names of the tags assigned to the file/folder.
Requires macOS 10.9.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.
Please note that some tags may include chr(10) followed by a number to indicate which label color is used for compatibility to older OS X versions. Those appear escaped as \n in the result.
You can use Files.GetFinderLabel to read label number.


Queries tag names:

Set Variable [$r; Value:MBS( "Files.GetTagNames"; "/Users/cs/Desktop/todo.rtf")]

See also

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 9th November 2021

Files.GetPosixPermissions - Files.IdentifyData