Documentation

Folders

Perhaps most confusing aspect of K-9 is the use of Classes to control the display and synchronization behavior of accounts and folders. The goal of the Class system is to provide an easy way for a person with a large number of folders to accomplish either of these two goals:

We didn’t want either use case to require going through nearly all of the folders, setting a parameter on each folder. To this end, there are settings to be made on both Account and Folders. If you do not make any Class setting changes, K-9 will display all of your folders, but will not perform automatic synchronization on any of them, until you change the “Email check frequency” in the Account settings.

Assigning classes

Classes can be used to adjust both the display of your folders and the automatic synchronization. Only displayed folders will be synchronized, irrespective of the synchronization class settings.

You can adjust the Account Class settings through the normal Account Settings Activity. To adjust the folder Class settings, use the new Folder Settings Activity. In the main folder list, long-press a folder. In Android Email, a long press on a folder does nothing. In K-9, it brings up a context menu, providing Refresh and Folder settings Click Folder settings to adjust the Classes to which the folder is assigned.

Folder display class

First is the Folder display class A folder can be assigned to be in 1st Class, 2nd Class or None. The default is None. If you have a lot of folders, and only want to display a few, then assign those few to 1st Class. If you have a lot of folders, and only want to hide a few, assign those few to 2nd Class, and leave the multitude set to None.

Folder sync class

Second, it is also possible to separately set the “Folder sync class”. By default, the folder’s sync class is the same as the folder’s display class. However, there are cases in which it is useful to have a different class for synchronization purposes. For instance, if there is a folder that you want to appear in your normal short list, but you do not want it to be automatically synced. Drafts is a good example of such a folder. In this case, assign the Drafts folder to be 1st Class for display but 2nd Class for sync. You will always have it in your folder list, but will not waste any battery power automatically keeping it in sync.

Modes

Now, in order to make use of the folder Class assignment, it is necessary to adjust two settings in the “Account settings”: “Folder display mode” and “Folder sync mode”.

Display mode

Folder display mode determines which folders are to be displayed. There are four choices:

Sync mode

Folder sync mode determines which folders are to be automatically synchronized at the “Email check frequency”.

There are four choices:

Examples

To show the utility of the various modes, it is probably best to show some use cases. In all cases, I have four folders available: Inbox, Janet, Carl and John.

Use case 1: Just a few folders

I want to see just my Inbox, Janet and Carl folders, and want all of those to be automatically synchronized. (Imagine I have 100 other folders that I do not want to see.)

Setting Account Inbox Janet Carl John
Display mode/class Only 1st Class folders 1st Class 1st Class 1st Class None
Sync mode/class Only 1st Class folders* Same as display class Same as display class Same as display class Same as display class

Use case 2: All but a few folders

I want to see and sync all of the folders, except for Carl. (Imagine I have 100 other folders I want to see.)

Setting Account Inbox Janet Carl John
Display mode/class *All except 2nd Class Folders* *None* *None* *2nd Class* *None*
Sync mode/class *All except 2nd Class Folders* *Same as display class* *Same as display class* *Same as display class* *Same as display class*

Use case 3: A few folders, only some automatically synchronized

I want to see only my Inbox, Carl and John folders, but I do not want the Carl folder to be automatically synchronized.

Setting Account Inbox Janet Carl John
Display mode/class *Only 1st Class folders* *1st Class* *None’’ *1st Class* *1st Class*
Sync mode/class *Only 1st Class folders* *Same as display class* *Same as display class’’ *2nd Class* *Same as display class*

Use case 4: A few core folders, sometimes a few more

I want to normally only see my Carl and Janet folders, often want to see my Inbox, but never want to see my John folder. All displayed folders are automatically synchronized.

Setting Account Inbox Janet Carl John
Display mode/class *Only 1st Class folders** *2nd Class* *1st Class* *1st Class* *None*
Sync mode/class *1st and 2nd Class folders* *Same as display class* *Same as display class* *Same as display class* *Same as display class*
*

To easily show the Inbox, and the imaginary other folders I want to sometimes see, just change the Account’s Folder display mode to 1st and 2nd Class folders.

Use case 5: A few core folders, sometimes a few more, only the core folders are ever synchronized

I want to normally only see my Carl and Janet folders, often want to see my Inbox, never want to see my John folder, but only Carl and Janet are automatically synchronized.

Setting Account Inbox Janet Carl John
Display mode/class *Only 1st Class folders** *2nd Class* *1st Class* *1st Class* *None*
Sync mode/class *Only 1st Class folders* *Same as display class* *Same as display class* *Same as display class* *Same as display class*
*

To easily show the Inbox, and the imaginary other folders I want to sometimes see, just change the Account’s “Folder display mode” to 1st and 2nd Class folders.