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

Use VBScript to Export or Import Categories

Slipstick Systems

› Developer › Code Samples › Use VBScript to Export or Import Categories

Last reviewed on June 19, 2021     1 Comment

The VBScripts on this page will export a list of your categories for backup and importing. If you have more than one data file, it will only export or import to the default data file. If a category already exists when you import, it is skipped.

I have VBA macros to export and import Categories (including one that gets or adds categories to every account in your profile) but it is a little too much work for one time use (unless you need the categories from all mailboxes) since you need to change Outlook's macro security settings. Using PowerShell is easier as you don't need to change Outlook's security settings to use it. VBScript doesn't need the security settings changed, is a one-click solution and can be used in a logon script.

Import or export color categories

Export Category names and colors

This code sample will write the category names, color code, and shortcut to a text file. You can delete the categories at the same time.

The exported list will look like this:

Newsletters,5,0
Business,2,0
Past,24,0
Accepted,3,0
EMO,10,0

To use, copy and paste the code sample into Notepad, change the file path to the desired location for the exported category list then save it with the vbs extension.

Double click to run the VBA file.

Dim objOutlook, objNS, objFolder
Set objOutlook = CreateObject("Outlook.Application")
Set objNS = objOutlook.GetNamespace("MAPI")
Dim objCat
Dim strOutput
 
' Get Categories 
If objNS.Categories.Count > 0 Then
        
    For Each objCat In objNS.Categories
       strOutput = strOutput & objCat.Name & ", " _
       & objCat.Color & ", " & objCat.ShortcutKey & vbCrLf

' to remove categories as you make the list
' uncomment this line
'objNS.Categories.Remove (objCat.CategoryID)
    Next
 End If

Set objFSO=CreateObject("Scripting.FileSystemObject")

' Provide file path
outFile="D:\Documents\categories.txt"
Set objFile = objFSO.CreateTextFile(outFile,True)

    objFile.WriteLine strOutput
  
objFile.Close

Import the Category names and colors

If you have a list of category names and colors, you can use this script to import them.

If you don't have an exported list, you can create one in Excel. You'll need three columns in each row (but no header row):

  1. Category name
  2. Color index (from 1 -25, see table below)
  3. Shortcut index (0 for no shortcut, 1 - 11 for the shortcuts).

When finished, save it as a CSV file. Before importing, open it in Notepad to verify that the category names or index numbers are not wrapped in quotes. If there are quotes, use Search and Replace to remove them.

Your finished list will look like this:

Newsletters,5,0
Business,2,0
Past,24,0
Accepted,3,0
EMO,10,0

Open a new file in Notepad, paste the code into it then change the file path to point to the text file you want to Import. Save it with the .vbs extension.

To run it: simply double click on the .vbs file you just saved. The categories will be added to the list. If the category names already exists, the entry is skipped.

Dim objOutlook, objNamespace, objFolder
Set objOutlook = CreateObject("Outlook.Application")
Set objNS = objOutlook.GetNamespace("MAPI")
Dim get_cat
Dim splitCategory
 
Set objFileToRead = CreateObject("Scripting.FileSystemObject").OpenTextFile("D:\Documents\categories.txt",1)
do while not objFileToRead.AtEndOfStream
get_cat= objFileToRead.ReadLine()
splitCategory = Split(get_cat, ",")

On Error Resume Next 
' use text file, no quotes around category name
objNS.Categories.Add splitCategory(0), splitCategory(1), splitCategory(2)
loop
objFileToRead.Close
Set objFileToRead = Nothing

 

Category Colors and Shortcut Keys

The following is a list of the category colors and their index number. Outlook 365 has brighter colors and some new color names, which are noted in the table.

ColorIndexColorIndex
Red1New: Gray
Old: Dark Gray
14
Orange2New: Dark Gray
Old: Black
15
Peach3Dark Red16
Yellow4Dark Orange17
New: Light Green
Old: Green
5New: Brown
Old: Dark Peach
18
New: Light Teal
Old: Teal
6New: Gold
Old: Dark Yellow
19
New: Lime Green
Old: Olive
7Dark Green20
Blue8New: Teal
Old: Dark Teal
21
New: Lavender
Old: Purple
9New: Green
Old: Dark Olive
22
New: Magenta
Old: Maroon
10New: Navy Blue
Old: Dark Blue
23
New: Light Gray
Old: Steel
11Dark Purple24
New: Steel
Old: Dark Steel
12New: Dark Pink
Old: Dark Maroon
25
New: Warm Gray
Old: Gray
13
ShortcutIndexShortcutIndex
Ctrl+F21Ctrl+F87
Ctrl+F32Ctrl+F98
Ctrl+F43Ctrl+F109
Ctrl+F54Ctrl+F1110
Ctrl+F65Ctrl+F1211
Ctrl+F76

More Information

See these article for other methods to import or export categories:
Create a List of Color Categories to Merge or Restore
Print a list of Outlook Categories and their Colors
Use PowerShell to Export and Import Categories

Use VBScript to Export or Import Categories was last modified: June 19th, 2021 by Diane Poremsky

Related Posts:

  • Create a List of Color Categories to Merge or Restore
  • Use PowerShell to Export and Import Categories
  • Use Upgrade to Color Categories to add Categories to the Master List
  • Print a list of Outlook Categories and their Colors

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
1 Comment
newest
oldest most voted
Inline Feedbacks
View all comments

PinkBlush (@guest_218500)
July 2, 2021 12:15 pm
#218500

Great content! Keep up the good work!

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