MsgFiler is highly configurable to your needs. To adjust its settings, choose Preferences from the MsgFiler menu or press Command-, while in MsgFiler. The Preferences window has four tabbed sections:

Note: This documentation is for MsgFiler 3.0.1. If you are running a previous version of MsgFiler, please upgrade to the latest version on the Mac App Store.

General Settings

Launch at login

Having MsgFiler launch at startup means its always available for you when working in Mail. Checking this box will cause MsgFiler to be added to your Login Items within the System Preferences Account pane.

Hide Dock Icon

Since MsgFiler is an application, it appears in your Dock when running. Check this box if you wish to hide the MsgFiler icon from the Dock. You may need to restart MsgFiler in order for your changes to take effect.

Hide MsgFiler Menu

The MsgFiler menu appears in Apple Mail to show you that it is running. Check this preference if you want to hide the MsgFiler menu in Mail.

List Font

Adjust the font used by MsgFiler in the mailboxes results list.

Pressing Shortcut

Pressing the keyboard shortcut to open MsgFiler can do one of two things:

Focuses between MsgFiler and Mail
This alternates focus on the Mail application and the MsgFiler window.
Toggles MsgFiler
This will open and close the MsgFiler window.
Shows MsgFiler
This will always open MsgFiler window.

Depending on your workflow, you may prefer one of these settings over the others. By default, this preference is set to toggle MsgFiler on and off.

MsgFiler Shortcut

The default shortcut is command-9 and only works while in Mail. If you change it, be sure to choose a keyboard combination that does not interfere with the operation of Mail.

To change the shortcut, click the field next to the label MsgFiler Shortcut. A prompt will appear in the label to choose a new shortcut. Type your new command. The change will be immediate.

Back to top

This section configures how MsgFiler searches for mailboxes in Mail.

Restrict search to selected accounts

This option allows you to file messages only to mailboxes contained in the currently selected account. For instance, suppose you have two mail accounts, all of which have a mailbox called Archive. When filing a message in one of the accounts, typing “Archive” will show matches for both mailboxes in all both mail accounts.

Enabling this preference ensures that only the mailbox named “Archive” of the currently selected mailbox account will be visible in the search results list.

Restrict search to selected accounts

Match on mailbox name only

By default, MsgFiler searches the entire mailbox path for matches. Check this box if you want to restrict MsgFiler to search on only the mailbox name itself.

You can also access this setting from the action menu of the MsgFiler window.

Enable case-sensitive search

By default, MsgFiler performs a case-insensitive search when matching mailboxes. Two mailboxes named “archive” and “Archive” are considered identical for search purposes. Enable this preference if you wish to make MsgFiler perform a case-sensitive search.

You can also access this setting from the action menu of the MsgFiler window.

Case-sensitive searching

Manage Excluded Mailboxes

You can exclude certain mailboxes and accounts from appearing in the mailboxes results list. Clicking on the button Manage Excluded Mailboxes… will bring up a sheet where you can add or remove excluded words. Any mailbox or account that include these words will be hidden from the results list.

Back to top

Filing Settings

Keep MsgFiler open after filing

Enabling this option prevents MsgFiler from closing after performing a filing operation. This is useful when you want to file dozens or hundreds of messages at a time. Having the MsgFiler window stay open after filing allows you to quickly type the next mailbox and hit Return to file.

You can also access this setting from the action menu of the MsgFiler window.

Use MsgFiler Engine to file messages

MsgFiler Engine is an optional Apple Mail plugin that you can install to make filing to remote IMAP mailboxes faster. It is not required, but is a welcome addition for those who are used to the performance of the previous MsgFiler 2 Mail Plugin. Learn more about the MsgFiler Engine here.

Note: Enabling the MsgFiler Engine to file your messages will disable the preference for moving the selection up or down after filing. Furthermore, undo/redo support will be handled by instead of MsgFiler.

Enter/Double-click performs

Pressing the Enter or Return key or double-clicking in the mailboxes results list will perform the default filing action. By default, this is Move Message, but you can change it to Copy Message, Show Mailbox or do nothing.

Move Message
Moves the selected messages in Mail to the selected mailbox.
Copy Message
Copies the selected messages in Mail to the selected mailbox.
Show Mailbox
Opens the frontmost message viewer in Mail to the selected mailbox.
You must click the buttons Move, Copy or Show to file your messages.

You can also toggle between the different default buttons from within the MsgFiler window by pressing these keyboard shortcuts:

Sets Show mailbox as the default action.
Sets Copy mailbox as the default action.
Sets Move mailbox as the default action.
Sets no default action.

Pressing Enter in search

After typing in the mailbox name in the search field, pressing Enter/Return can do one of two things:

Performs filing action
MsgFiler will file to the currently selected mailbox.
Focuses on the results list
MsgFiler will move focus from the search field to the mailbox results list.

Note: If only one item is visible in the mailbox results list, pressing Enter/Return will always perform the default filing action.

After filing, select

Selection up
Moves the cursor up one message in the frontmost Mail message viewer.
Selection down
Moves the cursor down one message in the frontmost Mail message viewer.

Note: When Mail reaches the end of the list of messages, it loses focus in the frontmost message viewer.

Note: When MsgFiler Engine is used to file messages, this preference is disabled.

Label filed messages

You can label filed messages with a color so you know that they have already been filed. By default, MsgFiler labels filed messages in green. You can adjust this setting so that MsgFiler:

Does not label filed messages with any color
Remove label
Removes any color labels on filed messages
Blue, Gray, Green, Orange, Purple, Red or Yellow
Labels filed messages with selected color

Back to top

Advanced Settings

Remember recent mailboxes

By default, MsgFiler will remember and display recently accessed mailboxes at the top of the mailboxes results list. Uncheck this box if you do not want MsgFiler to keep track of recently used mailboxes.

Display total number of filed messages

Show off to your friends with the number of messages you’ve filed with MsgFiler. This is a great way to see how much time you’ve saved over dragging and dropping.

Show welcome message on startup

When MsgFiler is first installed, a welcome message is displayed to the user. Check this box if you want the message to appear every time you launch MsgFiler.

Pressing escape in search

Closes MsgFiler
Pressing escape at any time will close MsgFiler.
Clears the search field
Pressing escape a second time will close MsgFiler.

Back to top