======Mappings======
In VPOP3, Mappings are a way of explicitly linking an email address to a user or list. They can also be used to indicate that an email address is remote, even though it would otherwise appear to be a local email address.

In other email servers, a similar feature may be called 'aliases'

=====Implied Mappings=====
In VPOP3, by default, a user (or list) will have implied Mappings of <username>@<domains> -> <username> . For an explanation of the <domains> value, see the //Domains to use// section of this article.

The implied Mappings only apply if there are no other Mappings which have matched the address previously.

You can turn off the implied Mappings, either in the [[local mail general|Local Mail -> General]] settings - the "Disable default user-> user mappings for local/incoming SMTP mail" option, or in the appropriate Mail Collector (POP3 Routing -> Configure Routing Options, the "Disable default user -> user mappings" option).

=====Domains to use=====
For implied Mappings or Mappings without an explicit email domain set, VPOP3 uses a list of domains set elsewhere for checking the mappings.

The <domains> list will depend on how the message is arriving at VPOP3.

For email which arrives at VPOP3 using SMTP, then the <domains> list is any domain listed in the [[local_mail_general#local_domains|Local Domains]] setting.

For email which arrives at VPOP3 using POP3 with header parsing, then the <domains> list is any domain listed in the [[route_by_parsing_message_headers|Accepted Domains]] setting of the appropriate [[Mail Collectors|Mail Collector]]

=====Mapping Settings=====
Each Mapping has 5 settings

===Email Address===
The email address setting tells VPOP3 which email address to look for when searching mappings. 

You can specify the email address as:
  - **<name>** - this will match <name> @ any of the applicable domains (see above)
  - **<name>@<domain>** - this will match the exact <name>@<domain> email address you have specified
  - **~@<domain>** - this will match any email address at the specified domain //as long as it does not match anything else//. "~@" is like saying "unrecognised addresses @"

You can use * and ? wildcards in the mappings, eg you could map ''*@mydomain.com -> me'', or ''albert-*@mydomain.com -> albert''

Note that, while you can use wildcards in the domain part of the email address, this should be used with care. For instance, if you have a mapping of ''bill@* -> bill'', then if a message is CC'd to bill@another.company.com, it will still be sent to your 'bill' user, even though that is probably not what was intended. Using wildcards in the domain part should probably be limited to using them if you have subdomains for divisions - eg ''sales@*.ourcompany.com -> sales'' would work if you wanted messages for sales@electronics.ourcompany.com and sales@jellybeans.ourcompany.com both to go to the 'sales' user/list.

If several Mappings match an email address, then all of them will be processed (except for ~@ Mappings)

===Target===
The Target is where any messages which match the Email Address part will be sent. You can choose any user/list from here.

==*REMOTE Target==
The *REMOTE target is a special case. This tells VPOP3 that the specified Email Address is a valid email address, but is not handled by this VPOP3 server. This can be useful if you have some users in your domain which are handled by another server.

For instance if you have a user **mike@mycompany.com** who collects his mail directly from a separate account at your ISP, you can create a Mapping of ''mike -> *REMOTE''.

What then is configured, then if a local user sends a message to mike@mycompany.com, rather than VPOP3 complaining that the 'mike' user doesn't exist, VPOP3 will put the message into the out queue to be sent to the Internet. Similarly, if a message comes in addressed to mike@mycompany.com, VPOP3 will simply ignore it (assuming that it has also been copied, by the ISP, to the relevant mailbox elsewhere).

See [[how_to:How to tell VPOP3 some users in the local domain are not to be handled by VPOP3]] for more details.

===Type===
The Type setting lets you limit when the Mapping applies. You can choose: 

  - **Always** - the Always option means that Mapping applies with both POP3 and SMTP mail
  - **POP3** - the POP3 option means the Mapping only applies when VPOP3 is downloading a message from a remote POP3 mail server
  - **SMTP** - the SMTP option means the Mapping only applies when VPOP3 is receiving a message via SMTP (either from a local or remote sender)
  - **FROM** - the FROM option means that the Mapping checks the **Sender** address rather than the recipient address. This only applies to incoming POP3 mail

===In Mail===
If the Type is set to POP3, then this tells VPOP3 which Mail Collectors the Mapping will apply to, you can choose either 'All In Mail Settings' or a specific Mail Collector

===Comments===
This allows you to set your own comments against the Mapping, for future reference