• Outlook User
  • New Outlook app
  • Outlook.com
  • Outlook Mac
  • Outlook & iCloud
  • Developer
  • Microsoft 365 Admin
    • Common Problems
    • Microsoft 365
    • Outlook BCM
    • Utilities & Addins

Assign Categories to Messages using Contact Category

Slipstick Systems

› Developer › Assign Categories to Messages using Contact Category

Last reviewed on May 2, 2016     7 Comments

This macro sample watches the Inbox for new messages and checks for a contact for the sender. If there is a contact and it has one or more categories assigned to it, the Contact's categories are added to the message.
Add Contact Categories to incoming messages

This macro, as written, is an ItemAdd macro and checks all messages that are added to the Inbox but it can be converted to run in a run a script rule instead. To use it to categorize messages already in your inbox or test it without sending messages, select a message and run the ContactCategoriesManual macro.

 
Private WithEvents olInboxItems As Items
 
Private Sub Application_Startup()
  Dim objNS As NameSpace
  Set objNS = Application.Session
  ' instantiate objects declared WithEvents
  Set olInboxItems = objNS.GetDefaultFolder(olFolderInbox).Items
  Set objNS = Nothing
End Sub
 
 'Use this to run the macro on a message already in the Inbox
Public Sub ContactCategoriesManual()
    Dim objMail As Object
    Set objMail = Application.ActiveExplorer.Selection.Item(1)
    olInboxItems_ItemAdd objMail  
Set objMail = Nothing
End Sub

Private Sub olInboxItems_ItemAdd(ByVal Item As Object)
'To use in a run a script rule
'Sub ContactCategories(Item As MailItem)
     Dim oContact As Outlook.ContactItem
     Dim oSender 
     
Set oSender = Item.Sender

If Not oSender Is Nothing Then

     Set oContact = oSender.GetContact
             Set oSender = Nothing
             
             If Not oContact Is Nothing Then
                 Item.Categories = oContact.Categories
                 Set oContact = Nothing
                 Item.Save
                         
            Set Item = Nothing
             End If
         End If
 End Sub

Move Messages to Folder Based on Contact Category

This version of the macro moves messages to a folder based on the category assigned to the sender's contact. This version of the macro works with multiple categories assigned to a contact but if the sender's contact has more than one category match, the message is not moved. You'll need to move the message to the correct folder yourself.

You can use partial category names in arrCategoryName, but you need to use enough characters to be unique. Use lower case!

Private WithEvents olInboxItems As Items
Dim olInbox As Outlook.Folder
  
Private Sub Application_Startup()
  Dim objNS As NameSpace
  Set objNS = Application.Session
' update with correct inbox
  Set olInbox = objNS.GetDefaultFolder(olFolderInbox)
  Set olInboxItems = olInbox.Items
  Set objNS = Nothing
End Sub
  
Private Sub olInboxItems_ItemAdd(ByVal Item As Object)
     Dim oContact As Outlook.ContactItem
     Dim oSender
     Dim strFolderName As String
     Dim strCategoryName As String
     Dim arrCategoryName As Variant
Dim arrFolder As Variant
Dim arr As Variant

j = 0
Set oSender = Item.Sender
 
If Not oSender Is Nothing Then
 
     Set oContact = oSender.GetContact
     Debug.Print oContact.FullName
             If Not oContact Is Nothing Then

  Debug.Print oContact.Categories
  strContactCats = oContact.Categories
' Set up the array, use lower case
arrCategoryName = Array("sales", "service", "accounting", "client")
' folder names subfolders of Inbox
arrFolder = Array("Sales", "Service Requests", "Accounting & Invoices", "Call Back")
 
' Go through the array and look for a match, then do something
For i = LBound(arrCategoryName) To UBound(arrCategoryName)
    If InStr(LCase(strContactCats), arrCategoryName(i)) > 0 Then
    j = j + 1
    strFolderName = arrFolder(i)
    Debug.Print j, strFolderName
    End If
Next i

' We count matches and don't move if there is more than one match
If j > 1 Then Exit Sub
If strFolderName = "" Then Exit Sub

' set the move to folder
Set MoveFolder = olInbox.Folders(strFolderName)
Item.Move MoveFolder

    Set Item = Nothing
    Set oContact = Nothing
    Set oSender = Nothing
    End If
End If
 End Sub

How to use this macro

First: You will need macro security set to low during testing.

To check your macro security in Outlook 2010 or 2013, go to File, Options, Trust Center and open Trust Center Settings, and change the Macro Settings. In Outlook 2007 and older, it’s at Tools, Macro Security.

After you test the macro and see that it works, you can either leave macro security set to low or sign the macro.

Open the VBA Editor by pressing Alt+F11 on your keyboard.

To use the macro code in ThisOutlookSession:

  1. Expand Project1 and double click on ThisOutlookSession.
  2. Copy then paste the macro into ThisOutlookSession. (Click within the code, Select All using Ctrl+A, Ctrl+C to copy, Ctrl+V to paste.)

More information as well as screenshots are at How to use the VBA Editor

Assign Categories to Messages using Contact Category was last modified: May 2nd, 2016 by Diane Poremsky

Related Posts:

  • Use a Macro to Assign Messages in a Shared Mailbox
  • Use Instant search to find messages from a contact
  • Assign an Email Account to an Outlook Contact
  • How to change the From field on incoming messages

About Diane Poremsky

A Microsoft Outlook Most Valuable Professional (MVP) since 1999, Diane is the author of several books, including Outlook 2013 Absolute Beginners Book. She also created video training CDs and online training classes for Microsoft Outlook. You can find her helping people online in Outlook Forums as well as in the Microsoft Answers and TechNet forums.

Subscribe
Notify of
7 Comments
newest
oldest most voted
Inline Feedbacks
View all comments

Ami Steane (@guest_218602)
August 7, 2021 11:21 am
#218602

Can this be used on sent emails as well?

0
0
Reply
Diane Poremsky(@diane-poremsky)
Author
Reply to  Ami Steane
August 7, 2021 9:12 pm
#218605

Not as written, but with a little tweaking, it could work on sent mail.

0
0
Reply
Brian (@guest_213507)
June 26, 2019 9:55 am
#213507

Hi Diane,
Is it possible to auto assign categories as emails come in with utilizing some sort of loop? For example, if 4 people utilize an inbox, I'd like to have the first incoming email be assigned to AA, the second incoming email assigned to BB, the third to CC, the fourth to DD, the 5th to AA, the 6th to BB, and so on.
Thank you for your help.

0
0
Reply
Andy Grant (@guest_211908)
September 10, 2018 6:09 pm
#211908

Now I've gotten two run-time errors:

The line Debug.Print oContact.FullName is triggering Run-time error 91 (Object variable or With block variable not set). When I hover over yellow section it reads: oContact.Fullname =

The line Set oSender = Item.Sender is triggering run-time error 438 (Object doesn't support this property or method). When I hover over the yellow line it reads: oSender = Empty

The good news is that the script actually did work for a minute and automatically sorted my incoming test email into the correct folder! That was a very happy moment for me!
Thanks!

0
0
Reply
Andy Grant (@guest_211906)
September 10, 2018 3:42 pm
#211906

Thank you so much! I think the mail sorter will work for me; one question has come up though. The line [Debug.Print oContact.Fullname] is highlighted in red. Previously Outlook threw me into debug mode and highlighted this line in yellow. I don't know what the issue is or how to proceed. Any ideas? Thank you.

0
0
Reply
Cris (@guest_198421)
May 4, 2016 4:20 am
#198421

Hi
I am getting a Compile Error: "Invalide attribute in Sub or Function" at "WithEvents olInboxItems As Items"

Can you direct me! Thanks, Cris

0
0
Reply
Diane Poremsky(@diane-poremsky)
Author
Reply to  Cris
May 4, 2016 8:30 am
#198427

Did you put the maco in ThisOutlookSession?
Is that line at the top of the page, above the Private Sub Application_Startup() line?

0
0
Reply

Visit Slipstick Forums.
What's New at Slipstick.com

Latest EMO: Vol. 30 Issue 15

Subscribe to Exchange Messaging Outlook






Support Services

Do you need help setting up Outlook, moving your email to a new computer, migrating or configuring Office 365, or just need some one-on-one assistance?

Our Sponsors

CompanionLink
ReliefJet
  • Popular
  • Latest
  • Week Month All
  • Use Classic Outlook, not New Outlook
  • How to Remove the Primary Account from Outlook
  • Disable "Always ask before opening" Dialog
  • Adjusting Outlook's Zoom Setting in Email
  • This operation has been cancelled due to restrictions
  • Remove a password from an Outlook *.pst File
  • Reset the New Outlook Profile
  • Maximum number of Exchange accounts in an Outlook profile
  • Save Attachments to the Hard Drive
  • How to Hide or Delete Outlook's Default Folders
  • Google Workspace and Outlook with POP Mail
  • Import EML Files into New Outlook
  • Opening PST files in New Outlook
  • New Outlook: Show To, CC, BCC in Replies
  • Insert Word Document into Email using VBA
  • Delete Empty Folders using PowerShell
  • Warn Before Deleting a Contact
  • Classic Outlook is NOT Going Away in 2026
  • Use PowerShell to Delete Attachments
  • Remove RE:, FWD:, and Other Prefixes from Subject Line
Ajax spinner

Recent Bugs List

Microsoft keeps a running list of issues affecting recently released updates at Fixes or workarounds for recent issues in classic Outlook (Windows).

For new Outlook for Windows: Fixes or workarounds for recent issues in new Outlook for Windows .

Outlook for Mac Recent issues: Fixes or workarounds for recent issues in Outlook for Mac

Outlook.com Recent issues: Fixes or workarounds for recent issues on Outlook.com

Office Update History

Update history for supported Office versions is at Update history for Office

Outlook Suggestions and Feedback

Outlook Feedback covers Outlook as an email client, including Outlook Android, iOS, Mac, and Windows clients, as well as the browser extension (PWA) and Outlook on the web.

Outlook (new) Feedback. Use this for feedback and suggestions for Outlook (new).

Use Outlook.com Feedback for suggestions or feedback about Outlook.com accounts.

Other Microsoft 365 applications and services




New Outlook Articles

Google Workspace and Outlook with POP Mail

Import EML Files into New Outlook

Opening PST files in New Outlook

New Outlook: Show To, CC, BCC in Replies

Insert Word Document into Email using VBA

Delete Empty Folders using PowerShell

Warn Before Deleting a Contact

Classic Outlook is NOT Going Away in 2026

Use PowerShell to Delete Attachments

Remove RE:, FWD:, and Other Prefixes from Subject Line

Newest Code Samples

Insert Word Document into Email using VBA

Warn Before Deleting a Contact

Use PowerShell to Delete Attachments

Remove RE:, FWD:, and Other Prefixes from Subject Line

Change the Mailing Address Using PowerShell

Categorize @Mentioned Messages

Send an Email When You Open Outlook

Delete Old Calendar Events using VBA

Use PowerShell or VBA to get Outlook folder creation date

Rename Outlook Attachments

VBA Basics

How to use the VBA Editor

Work with open item or selected item

Working with All Items in a Folder or Selected Items

VBA and non-default Outlook Folders

Backup and save your Outlook VBA macros

Get text using Left, Right, Mid, Len, InStr

Using Arrays in Outlook macros

Use RegEx to extract message text

Paste clipboard contents

Windows Folder Picker

Custom Forms

Designing Microsoft Outlook Forms

Set a custom form as default

Developer Resources

Developer Resources

Developer Tools

VBOffice.net samples

SlovakTech.com

Outlook MVP David Lee

Repair PST

Convert an OST to PST

Repair damaged PST file

Repair large PST File

Remove password from PST

Merge Two Data Files

Sync & Share Outlook Data

  • Share Calendar & Contacts
  • Synchronize two computers
  • Sync Calendar and Contacts Using Outlook.com
  • Sync Outlook & Android Devices
  • Sync Google Calendar with Outlook
  • Access Folders in Other Users Mailboxes

Diane Poremsky [Outlook MVP]

Make a donation

Mail Tools

Sending and Retrieval Tools

Mass Mail Tools

Compose Tools

Duplicate Remover Tools

Mail Tools for Outlook

Online Services

Calendar Tools

Schedule Management

Calendar Printing Tools

Calendar Reminder Tools

Calendar Dates & Data

Time and Billing Tools

Meeting Productivity Tools

Duplicate Remover Tools

Productivity

Productivity Tools

Automatic Message Processing Tools

Special Function Automatic Processing Tools

Housekeeping and Message Management

Task Tools

Project and Business Management Tools

Choosing the Folder to Save a Sent Message In

Run Rules on messages after reading

Help & Suggestions

Submit Outlook Feature Requests

Slipstick Support Services

Buy Microsoft 365 Office Software and Services

Visit Slipstick Forums.

What's New at Slipstick.com

Home | Outlook User | Exchange Administrator | Office 365 | Outlook.com | Outlook Developer
Outlook for Mac | Common Problems | Utilities & Addins | Tutorials
Outlook & iCloud Issues | Outlook Apps
EMO Archives | About Slipstick | Slipstick Forums
Submit New or Updated Outlook and Exchange Server Utilities

Send comments using our Feedback page
Copyright © 2025 Slipstick Systems. All rights reserved.
Slipstick Systems is not affiliated with Microsoft Corporation.

wpDiscuz

Sign up for Exchange Messaging Outlook

Our weekly Outlook & Exchange newsletter (bi-weekly during the summer)






Please note: If you subscribed to Exchange Messaging Outlook before August 2019, please re-subscribe.

Never see this message again.

You are going to send email to

Move Comment