MailItem.RetentionExpirationDate Property (Outlook)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Returns a Date that specifies the date when the MailItem object expires, after which the Messaging Records Management (MRM) Assistant will delete the item. Read-only.

expression .RetentionExpirationDate

expression A variable that represents a MailItem object.

A retention policy is enabled and disabled by an administrator for an Exchange Server on a mailbox level. This feature is available only on an Exchange mailbox with MRM version 2.0 or later enabled.

Microsoft Outlook calculates the value of this property based on the item retention start date and the retention period, if Outlook is in cache or offline mode. The Exchange Server specifies the value if Outlook is in online mode.

In general, the retention start date for the item is determined as follows:

  • Received or sent items: the retention start date is the received date.

  • Nonrecurring calendar items: the retention start date is the appointment end date.

  • Recurring calendar items: the retention start date is the end date of last recurrence. If there is no end date, the item never expires.

Show: