Files.SetTagNames
-----------------

Sets the tags for a file/folder.

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

MBS( "Files.SetTagNames"; Path; Taglist ) 

**MBS**( **"Files.SetTagNames";** /\* Sets the tags for a file/folder. \*/  
**$Path**; /\* The native path to the file.e.g. "/Users/cs/Desktop/test.txt" \*/   
**$Taglist**) /\* The list of tags names, separated by newline character.e.g. "Hello World" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Path | The native path to the file. | "/Users/cs/Desktop/test.txt" |
| Taglist | The list of tags names, separated by newline character. | "Hello World" |

### Result

Returns OK or error.

### Description

Sets the tags for a file/folder.  
Requires macOS 10.9.  
This function needs a native path. Please use [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md) function in order to convert a FileMaker style path to a native path.  
Please note that some tags may include Char(10) followed by a number to indicate which label color is used for compatibility to older OS X versions. Those should appear escaped as \\n in the taglist.  
### See also

- [Files.GetTagNames](FilesGetTagNames.md)
- [Files.SetFinderLabel](FilesSetFinderLabel.md)
- [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md)

### Blog Entries

- [MBS Filemaker Plugin, version 3.5pr2](https://www.mbsplugins.de/archive/2013-10-22/MBS_Filemaker_Plugin_version_3/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 10th August 2020

  
[Files.SetSystemImmutable](FilesSetSystemImmutable.md) - [Files.SetUserImmutable](FilesSetUserImmutable.md)

[HTML Version](FilesSetTagNames.shtml)