Email Client Integration Settings

You can specify messages to be automatically associated with contact persons and customers in M-Files. M-Files does this on the basis of the sender and recipient information when the messages are saved to your vault in Microsoft Outlook. For an introduction to this feature, see Associating Messages with Contacts.

For information on how this feature is supported in different M-Files clients, refer to M-Files Feature Comparison.

To open the Email Client Integration Settings dialog:

  1. Open M-Files Admin.
  2. In the left-side tree view, expand a connection to M-Files server.
  3. Expand Document Vaults.
  4. Right-click a vault and select Email Client Integration Settings.

Contact persons

M-Files looks for a match with a contact person's email address. M-Files associates the message with the contact person Matt Bay if the properties of the contact person object have the same email address as the message ([email protected]).


If you have specified customer information in the email integration settings:

  1. M-Files looks for customer matches through the contact person information (the Customer object type must be the owner of the Contact person object type): M-Files associates the message with the customer ESTT if Matt Bay is the contact person for ESTT.
  2. M-Files looks for similarity between the domain name in the email address and the customer's properties: M-Files associates the message with the customer ESTT on the basis of the email address domain, or, if the domain is found in the customer's properties. The message is not associated with any contact person, unless a full match is found with the contact person information.

Advanced Settings

On the Advanced tab, you can further specify associations between email information and M-Files metadata. M-Files automatically populates the metadata card according to the defined mappings.

Note: These settings are in use in these situations:
  • You drag and drop the email from Microsoft Outlook to M-Files.
  • You select Save to M-Files from the Microsoft Outlook ribbon.

You can select a default class for all the email messages that are saved to M-Files with Microsoft Outlook. If you use the standard Microsoft Outlook integration, specify the default class here. If you use M-Files for Outlook, the user selects the default class in the add-in options in Microsoft Outlook. In other words, M-Files for Outlook does not use the default email class that is specified in Email Client Integration Settings.

With the other options on the Advanced tab, you can define an appropriate metadata property for the value of each email header field.

For example, if you want M-Files to automatically insert the information from the From field to a certain property on the metadata card of the email object, select the appropriate property from the drop-down menu.

Accepted data types

There are limitations for the data types of the properties that are assigned to object metadata with these settings. You can see the accepted data types in the table. You must also allow the properties to be used with the Document object type (or with all object types).

Email header field Accepted data types
  • Text (multi-line)
  • Text
  • Text (multi-line)
  • Text (multi-line)
  • Text
  • Text (multi-line)
  • Timestamp
  • Timestamp
  • Text
  • Text (multi-line)
  • Text
  • Text (multi-line)

M-Files for Outlook

If you use M-Files for Outlook, specify the settings on the M-Files for Outlook tab. For more information, refer to Configuring M-Files for Outlook.