# Mail Folders

The Mail Folders screen allows you to either select a different mail folder to view or to create, rename or delete mail folders (mailboxes) and directories. The default set of mail folders on __SERVICE__ is `INBOX`, `sent-mail` and `received`. The Mail Folders screen looks something like the following:-

Create under with name
| Refresh | | | Transfer Folders | | | Favourite Folders

INBOX |  |  | received | Rename | Delete | saved-messages | Rename | Delete | sent-mail | Rename | Delete | testdir | Rename | Delete

Create under with name
| Refresh | | | Transfer Folders | | | Favourite Folders

## The bars above and below the folder listing

Create under with name

This enables the creation of mail folders or directories. For example selecting mailbox and typing a name such as `projects` will, once the Create button has been pressed, cause the display to change to include the newly created mail folder. Mailboxes can be created under existing directories.

Refresh | checks the contents of the directory on the __SERVICE__.
Transfer Folders | allows you to upload a local mail folder to __SERVICE__ or download a mail folder from __SERVICE__ to your local machine.
Favourite Folders | displays a screen where you can choose a folder, or folders, to be added to a list of favourite mail folders. This list appears in the pull-down listing in the common toolbar, replacing the list of default folders. Once you have one or more Favourite mail folders an expanded set of actions becomes available. These are described on the help page associated with the Favourites selection screen.

## The folder listing

You can keep all your mail in different folders in one directory, or you can create a storage system of directories that contain mail folders (the example given in this help text). While you can create mail folders in any directory, you need to be aware that different mail clients default to looking in different places.

- The Folder icon indicates that the line refers to a mail folder and also shows the name of the folder and actions that can be performed on that folder, for example:-

  saved-messages | Rename | Delete

  Selecting the folder icon or the name of the folder will display a listing of the messages in that folder. To return to the folder listing screen again, select the Folders icon in the common toolbar.
  Other actions you can take on a mail folder are:-
  - Rename - takes you to a screen with a form allowing you to rename the mail folder.
  - Delete - deletes the mail folder. Selecting this leads to a screen where you need to choose to confirm or cancel the deletion. Once the mail folder is deleted the display of the mail folders is updated and the Status information reflects the success of the action, for example

    Status: Deleted mailbox: "mail/newtest"

- The Right arrow indicates that the line refers to a directory, and shows the name of the directory and the actions that can be performed, for example:-

  testdir | Rename | Delete

  Selecting the arrow, or the name of the directory, will display a listing of the mail folders in that directory.
  The other actions are
  - Rename - takes you to a screen with a form allowing you to rename the directory.
  - Delete - deletes the directory. Selecting this leads to a screen where you need to choose to confirm or cancel the deletion.
    Note: You can only delete a directory if it has no mail folders inside it. If the deletion is not successful the Status information reflects the reason, for example if you try to delete a non-empty directory the message is:-

    Status: DELETE failed: Can't delete mailbox mail/testdir/: File exists