Specifying how Domino looks up the recipients of incoming SMTP messages

When Domino® receives a message over SMTP, the message recipient is identified by an Internet-style address, in the format Genevieve_Martin@renovations.com, rather than a Notes-style address, such as Genevieve Martin/Renovations. To determine the correct destination mail file, Domino must match the SMTP address to a Person document in the Domino Directory. To find a match, the Router checks the $Users view of the directory. This view displays all name entries in all Person documents in the directory, including Internet mail addresses, as well as all user name variations, first names, last names, common names (CN), distinguished names (DN), short names, and soundex names.

About this task

Inbound recipient lookups are controlled by the Address lookup setting on the Router/SMTP > Basics tab of the Configuration Settings document. This setting determines the criteria that the Router uses when attempting to match the SMTP address on an incoming message to an entry in the $Users view.

Note: To display the hidden $Users view: Open the directory, press CTRL-SHIFT and select View > Go To. In the Go To dialog box, select the view ($Users) and click OK.

The Router matches addresses based on:

  • The full SMTP address only -- for example, Genevieve_Martin@renovations.com
  • The local part of the SMTP address (that is, the part before the @ sign) only -- for example, Genevieve_Martin
  • The full SMTP address, and then if no match is found, the local part address

When using full name matching, the Router searches the Domino Directory for an exact match of the entire SMTP address (for example, First_Last@Renovations.com). If an exact match is not found, the Router performs a secondary search if the domain suffix of the incoming address is listed in the Global domain document as an Internet domain alias. For this secondary search, the Router replaces the given domain suffix with the domain suffix designated in the Global domain document as the Primary domain name.

To prevent the Router from using domain aliases when looking up addresses, do not include alternate Internet domain aliases in a Global domain document. Instead, create multiple Global Domain documents, each specifying a different primary Internet domain.

Restricting the Router to matching addresses on the full Internet address only ensures that each user's Internet address complies with a standard format. Users cannot receive inbound mail addressed to their short names, soundex names, or other name variations that exist in the $Users view. When configuring the Router to look up users' full Internet addresses only, complete the Internet address field in all Person documents, and Mail-in database documents for mail-in databases that receive mail over SMTP.


  1. Make sure you already have a Configuration Settings document for the server(s) to be configured.
  2. From the Domino Administrator, click the Configuration tab and then expand the Messaging section.
  3. Choose Configurations.
  4. Select the Configuration Settings document to be edited and then click Edit Configuration.
  5. Click the Router/SMTP - Basics tab.
  6. Complete these fields, and then save the document:
    Table 1. Lookup fields on the Basics tab
    Field Enter
    Address lookup

    Specifies how the Router searches the Domino Directory to determine the Notes® recipient of an inbound Internet message. Choose one:

    • Fullname then Local Part - (default) The Router first searches the Domino Directory for a match for the full Internet address (localpart@domain.com). If no match is found, it searches the directory again, looking for a match for the local part of the address only.
    • Fullname only - The Router searches the Domino Directory for full Internet addresses only. For example, it searches for user@domain.com but not for user. If an exact match is not found and the domain suffix is equivalent to an Internet domain alias defined in the Global domain document, a secondary search is performed using the domain suffix of the primary Internet domain.
    • Local Part only - The Router searches the Domino Directory for a match of the local part of the Internet address, that is, the part before the at (@) symbol. Local part matching matches periods and underscores in the address with spaces in the directory.
    Exhaustive lookup

    Choose one:

    • Enabled - The Router searches all directories to ensure that there are no duplicate recipient names that might prevent the message from reaching the correct person. Performing exhaustive lookups is time-consuming and places a heavy load on the server.
    • Disabled - (default) The Router limits its search to the first directory that contains the address.


The change takes effect after the next Router configuration update. To put the new setting into effect immediately, reload the routing configuration.