Each rule starts with one or more conditions you specify. Each condition, in turn, starts with an attribute—a quality of a file or folder in the monitored folder that Hazel can examine. Conditions can use a wide selection of attributes. (And, if none of these attributes provide you with the information you need, you can create your own custom attributes using AppleScript, JavaScript, or match patterns. See Using Custom Attributes for details.)
Hazel recognizes the following attributes:
Name
The name of the file (or folder), without any extension. So, if you have a file called example.jpg , this attribute matches against example .
Extension
The file’s extension, which is the part of the file name after the last dot (.). The file example.jpg has the extension jpg . (By default, extensions are hidden in the Finder, but Hazel matches them regardless of whether they’re visible. To toggle the visibility of extensions in the Finder, go to Finder > “Preferences” > “Advanced” and select or deselect “Show all filename extensions.”)
Full Name
The full name of the file (or folder)—that is, the name plus the extension.
Date Added
The date (including time) when the file was added to the current folder. This attribute is useful for determining how long a file has been in the monitored folder. (See Note below.)
Date Created
The date (including time) the file was created. (See Note below.)
Date Last Modified
The date (including time) the file was last changed. (See Note below.)
Date Last Opened
The date (including time) the file was last opened. (See Note below.)
Date Last Matched
The date (including time) when the file or folder last matched a rule and the rule’s actions ran successfully. (See Note below.)
Current Time
The current time at the moment the rule runs. (See Note below.)
Note: When using any of the above “Date” attributes with “occurs before” or “occurs after,” or the “Current Time” attribute, keep in mind that Hazel treats each day as starting or ending at midnight. So, if you set up a condition like “current time is after 10 PM on weekdays,” the condition matches only from 10 PM until midnight each weekday—Hazel does not consider 12:01 AM the following morning to be “after” 10 PM.
Kind
The type of file, such as a document, movie, or folder. With second pop-up menu set to “is” or “is not,” choose “Other” from the third pop-up menu to display a list of all available file types on your Mac.
Tags
Any tag that can be assigned in the Finder. When the second pop-up menu is set to “contains tags” or “does not contain tags,” clicking in the field that appears displays a list of all currently defined Finder tags (click Show All to display all tags if the list is long). If the second pop-up menu is set to “contain” or “do not contain,” you can enter any freeform text in the field.
If the second pop-up menu is set to “match” or “do not match,” you can enter a match pattern in the field, and optionally grab text so that it can be used in your actions.
Color Label
The color label, if any, applied to the file. This will match any of the tags which are currently associated with that color.
Comment
Freeform notes associated with a file or folder. You can see and edit these comments in the Finder by selecting the file or folder and choosing File > “Get Info.”
Size
The size of the file. Because of the way macOS calculates sizes, this figure (the actual size) may be less than the amount of space the file occupies on disk.
Contents
The text content of the file. If the second pop-up menu is set to “contain” or “do not contain,” you can match any words that Spotlight has indexed for this file. That is, if you can find the file via Spotlight using a certain word, Hazel can also match that word in the file’s contents.
If the second pop-up menu is set to “contain match” or “do not contain match,” you can enter a match pattern in the field, and optionally grab text so that it can be used in your actions.
Source URL/Address
The URL or email address the file came from. Note that only certain apps, such as Safari and Mail, store this information.
Subfolder Depth
The number of subfolders in the folder, starting from the folder being monitored. This is useful only if you have a rule set up to descend into subfolders using the “Run rules on folder contents” action (see Processing Subfolders ). A subfolder depth of 0 indicates the folder being monitored.
Sub-file/folder Count
How many files and folders are contained by the item being matched by the rule (preferably a folder). This counts the number of items at the top level of the monitored folder, not those contained in subfolders. If the current item being processed is a file, this number is 0. (This is similar to Spotlight’s Number of Items attribute except that this does not include hidden files in the count.)
Any File
This attribute matches all files (and folders). This is useful when the final rule for a given folder is a “catch-all” rule that applies to any files or folders that don’t match any of the previous rules—but it makes sense only when it is the sole condition in a rule.
Passes AppleScript
Allows you to provide an AppleScript to evaluate the file. For details on writing AppleScript for Hazel, see Using AppleScript or JavaScript .
Passes JavaScript
Allows you to provide a JavaScript to evaluate the file. For details on writing JavaScript for Hazel, see Using AppleScript or JavaScript .
Passes shell script
Allows you to provide a shell script to evaluate the file. For details on writing shell scripts for Hazel, see Using Shell Scripts .
Other
This attribute allows you to select any Spotlight attribute, of which macOS may have dozens or hundreds (depending on which apps you have installed).
SEE ALSO