1##
2## Mailbox definitions
3##
4
5# Each mailbox is specified in a separate mailbox section. The section name
6# specifies the mailbox name. If it has spaces, you can put the name
7# "in quotes". These sections can contain the following mailbox settings:
8#
9# auto:
10#   Indicates whether the mailbox with this name is automatically created
11#   implicitly when it is first accessed. The user can also be automatically
12#   subscribed to the mailbox after creation. The following values are
13#   defined for this setting:
14#
15#     no        - Never created automatically.
16#     create    - Automatically created, but no automatic subscription.
17#     subscribe - Automatically created and subscribed.
18#
19# special_use:
20#   A space-separated list of SPECIAL-USE flags (RFC 6154) to use for the
21#   mailbox. There are no validity checks, so you could specify anything
22#   you want in here, but it's not a good idea to use flags other than the
23#   standard ones specified in the RFC:
24#
25#     \All       - This (virtual) mailbox presents all messages in the
26#                  user's message store.
27#     \Archive   - This mailbox is used to archive messages.
28#     \Drafts    - This mailbox is used to hold draft messages.
29#     \Flagged   - This (virtual) mailbox presents all messages in the
30#                  user's message store marked with the IMAP \Flagged flag.
31#     \Important - This (virtual) mailbox presents all messages in the
32#                  user's message store deemed important to user.
33#     \Junk      - This mailbox is where messages deemed to be junk mail
34#                  are held.
35#     \Sent      - This mailbox is used to hold copies of messages that
36#                  have been sent.
37#     \Trash     - This mailbox is used to hold messages that have been
38#                  deleted.
39#
40# comment:
41#   Defines a default comment or note associated with the mailbox. This
42#   value is accessible through the IMAP METADATA mailbox entries
43#   "/shared/comment" and "/private/comment". Users with sufficient
44#   privileges can override the default value for entries with a custom
45#   value.
46
47# NOTE: Assumes "namespace inbox" has been defined in 10-mail.conf.
48namespace inbox {
49  # These mailboxes are widely used and could perhaps be created automatically:
50  mailbox Drafts {
51    special_use = \Drafts
52  }
53  mailbox Junk {
54    special_use = \Junk
55  }
56  mailbox Trash {
57    special_use = \Trash
58  }
59
60  # For \Sent mailboxes there are two widely used names. We'll mark both of
61  # them as \Sent. User typically deletes one of them if duplicates are created.
62  mailbox Sent {
63    special_use = \Sent
64  }
65  mailbox "Sent Messages" {
66    special_use = \Sent
67  }
68
69  # If you have a virtual "All messages" mailbox:
70  #mailbox virtual/All {
71  #  special_use = \All
72  #  comment = All my messages
73  #}
74
75  # If you have a virtual "Flagged" mailbox:
76  #mailbox virtual/Flagged {
77  #  special_use = \Flagged
78  #  comment = All my flagged messages
79  #}
80
81  # If you have a virtual "Important" mailbox:
82  #mailbox virtual/Important {
83  #  special_use = \Important
84  #  comment = All my important messages
85  #}
86}
87