Files.SetFinderLabel
--------------------

Sets the Finder label.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Files](component_Files.md) | [6.2](newinversion62.md) | ✅ Yes | ❌ No | ❌ No | ✅ Yes, on macOS | ❌ No |

MBS( "Files.SetFinderLabel"; Path; Label ) 

**MBS**( **"Files.SetFinderLabel";** /\* Sets the Finder label. \*/  
**$Path**; /\* The native path to the file.e.g. "/Users/cs/Desktop/test.txt" \*/   
**$Label**) /\* The new label number.   
0 = no label  
1 to 7 give different colors.e.g. 1 \*/ 

### Parameters

| 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. | 1 |

### Result

Returns OK or error.

### Description

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](FilesSetTagNames.md) to set tag names if needed.  
  
This function requires a native path. Use [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md) 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](component_FileDialog.md) functions.  
For Server be aware that server has limited permissions and may not be able to access all files on a computer.  
### Examples

Set color to green:

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

- [Files.GetFinderLabel](FilesGetFinderLabel.md)
- [Files.SetTagNames](FilesSetTagNames.md)
- [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md)

### Blog Entries

- [MBS FileMaker Plugin 6.2 for OS X/Windows](https://www.mbsplugins.de/archive/2016-05-24/MBS_FileMaker_Plugin_62_for_OS/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 6.2pr10](https://www.mbsplugins.de/archive/2016-05-20/MBS_FileMaker_Plugin_version_6/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

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

  
[Files.SetFileExtensionHidden](FilesSetFileExtensionHidden.md) - [Files.SetHidden](FilesSetHidden.md)

[HTML Version](FilesSetFinderLabel.shtml)