# Labels and Status Icons

The **Labels** system lets you assign your own labels to files and folders. A label has a name, and can define colors and font styles that modify the appearance of labeled files. Labels can also be used to override the default icon image for a file or folder, or define a status icon that can be shown in a separate column to flag important files. They can also cause a file or folder to become "pinned" to the top of the file list.

By default Opus defines five labels - _Blue_, _Green_, _Orange_, _Purple_ and _Red_, and four status icons - _Checked_, _Flagged_, _Important_ and _Pinned_.  You can use these labels (what you interpret them to mean is up to you) or define your own. For example, you could define a label called _Really Important_ that displays files in red italics.

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-0aa4ec61d299df61f76d1c3ce185692093c92586%2Flabels_2.png?alt=media)

Labels are defined through the [Label Definitions](../preferences/preferences_categories/labels/label_definitions) page in Preferences.

### Assigning labels

You can apply labels to files and folders on an ad-hoc basis, using the **Properties** drop-down menu on the default toolbar. The _Set Label_ and _Set Status_ sub-menus display a list of your defined labels and status icons, and lets you apply them automatically to selected files and folders.

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-dbf812f50708e5a1acb65a17dcada5b293408311%2Flabels_status.png?alt=media)

To label a file, select it, and then choose the appropriate label from this drop-down. Depending on the label definition, the file will change color instantly to match the assigned label.

Note that the options in the Status category are all still labels - they've simply been grouped under "Status" because all they do is define status icons. You can change this and create your own groups if you want.

### Stacked labels

More than one label may apply to a single file, and labels can “stack” on top of each other. For example, one label could turn all JPEG filenames green, while another might use bold for images which are at least 1920x1080 pixels. A 1920x1080 JPEG file would then have a bold green name. Each label definition has a “stop on match” flag which lets you prevent further combinations - once a label with “stop on match” is encountered, no further labels will be processed for that file.

### Wildcard labels

The [Label Assignments](../preferences/preferences_categories/labels/label_assignments) page in Preferences lets you apply labels to files and folders using wildcard patterns. For example, you could cause all Word documents to be labeled _Green_ by creating a wildcard label assignment for **\*.doc** files. Labels can also use [filters](filtered_operations) to perform tests based on attributes other than file name or path.

By default explicitly applied labels override wildcard labels, but the Preferences setting _Favorites and Recent / Labels / Apply wildcard and label filters to explicitly labeled files and folder_ lets wildcard labels stack on top of explicitly-assigned ones.

### Overriding file icons

In the image below, you can see an example of a label filter that is used to override icons for particular files. A label has been created (called **HD Image**) that defines a custom icon. A label filter has also been created that matches JPG files (it could be used to match more filetypes if desired) with a height of at least 1080 pixels. You can see in the Lister image at the bottom that the high resolution images are displayed with the custom icon, whereas the smaller images have the standard JPG icon.

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-d334fab9c6f3aa3d1c51f0ac2ac9a141a1b0c647%2Fcustom_icons.png?alt=media)

### Label storage

There are two ways that Opus can store labels that are assigned to a specific file or folder (as opposed to a wildcard or filter-based label).&#x20;

* On an NTFS-formatted drive (which is the most common type of file system these days) the label information is stored in an alternate data stream with the actual file itself. The advantage of this is that when you copy, move or rename the file, the label goes with it (if enabled on the [Copying Files / Attributes](../preferences/preferences_categories/file_operations/copying_files/attributes) page in Preferences).
* On other file systems, or if the option to store labels in the file system is turned off (on the [Labels / Options](../preferences/preferences_categories/labels/options) page in Preferences), Opus stores a list of the full filename and path of labeled files. That means that if you move a labeled file, the label will not go with it. You can view a list of all files labeled in this way from the **Label Assignments** page in Preferences, and use the controls there to clean up the labeled file list.

### TortoiseSVN support

For developers using the free TortoiseSVN source code control utility, Opus can optionally display a file’s SVN status as an icon in the _Status_ column. This is controlled by the **Show TortoiseSVN icons in the Status column** option on the [File Display Columns / Icons](../preferences/preferences_categories/file_display_columns/icons) page in Preferences. If turned on, Opus will automatically add the appropriate SVN status icon to any other label icons displayed in the _Status_ column.

Other than the status icon appearing larger and more distinctive than the usual icon overlay that Tortoise uses, this can help with the problem of limited icon overlays. Windows only allows a maximum of 15 icon overlays in the system, and Tortoise normally uses 8 or more of these for itself, crowding out other shell extensions. Using this option in Opus gets around the limit as the status is taken directly from Tortoise rather than via the icon overlay.

Note that this feature requires TortoiseSVN version 1.9.3 or greater.
