Home › Knowledgebase › KB-566

How to fix Microsoft Outlook Quick Steps not working or failing to run on incoming emails

Summary

This guide helps you troubleshoot and resolve: How to fix Microsoft Outlook Quick Steps not working or failing to run on incoming emails. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

Outlook Quick Steps are a powerful way to automate common email actions, such as moving messages to a specific folder, applying categories, or forwarding to a colleague. When they stop working on incoming emails, it is usually due to a corrupted Quick Step, an outdated mailbox cache, conflicting rules, or an issue with the Outlook profile. This guide walks you through the most effective fixes, starting with the quickest solutions and moving to more thorough repairs.

Important: Quick Steps Are Manual Actions

By default, Outlook Quick Steps do not run automatically when new emails arrive. They are manual actions that you trigger from the ribbon on selected messages. If you expect a Quick Step to process incoming mail automatically, you must combine it with an Outlook rule, or use rules alone for automatic processing.

Quick Fix Steps

If you are short on time, work through these steps first. Most Quick Step issues are resolved within the first three.

  1. Restart Outlook completely (close from the system tray on Windows, or force quit on Mac).
  2. Recreate the affected Quick Step from scratch.
  3. Check for conflicting Outlook rules that may be blocking the Quick Step.
  4. Update Outlook to the latest version.
  5. Clear the Outlook cache.

Detailed Instructions

1. Restart Outlook and Your Device

A simple restart clears temporary glitches that often cause Quick Steps to fail silently. On Windows, right-click the Outlook icon in the system tray and select Close window, then reopen Outlook. On Mac, right-click the Outlook icon in the Dock and choose Quit. If the issue persists, restart your computer entirely.

2. Repair Outlook Data Files

Corrupted Outlook data files can cause Quick Steps to fail. The repair method depends on your account type.

For POP/IMAP accounts (.pst files)

Use the Microsoft Inbox Repair Tool (ScanPST) for .pst files:

  1. Close Outlook.
  2. Open File Explorer and navigate to C:\Program Files\Microsoft Office\root\Office16 (the path may vary slightly depending on your Office version).
  3. Double-click SCANPST.EXE.
  4. Click Browse and locate your Outlook data file. The default location is %LOCALAPPDATA%\Microsoft\Outlook.
  5. Click Start and allow the scan to complete.
  6. If errors are found, click Repair and follow the prompts.
  7. Restart Outlook and test your Quick Step.

For Microsoft 365 and Exchange accounts (.ost files)

ScanPST is not designed for .ost files. These files are offline caches that synchronise with the server. To resolve issues:

  1. Close Outlook.
  2. Navigate to %LOCALAPPDATA%\Microsoft\Outlook.
  3. Rename the affected .ost file (for example, add .old to the filename).
  4. Restart Outlook. Outlook will rebuild the .ost file by re-syncing with the mail server.
  5. Test your Quick Step once synchronisation completes.

3. Recreate the Quick Step

Quick Steps can become corrupted, particularly after Office updates. Recreating them is often the fastest permanent fix.

  1. In Outlook, go to the Home tab.
  2. In the Quick Steps group, click the small arrow in the bottom-right corner to open Manage Quick Steps.
  3. Select the existing Quick Step and click Edit, or click New to create one from scratch.
  4. Choose an action (for example, Move to folder) from the dropdown.
  5. Configure the action exactly as required.
  6. Click Finish.
  7. Test the new Quick Step on an incoming email.
Quick Steps cannot be exported through File → Options → Mail. They are stored within your Outlook profile and mailbox. If you move to a new profile or device, you will need to recreate them manually.

4. Combine Quick Steps with Rules for Automatic Processing

Because Quick Steps are manual, they do not run on incoming mail by themselves. To automate processing, use an Outlook rule to move or categorise messages, then apply the Quick Step manually when needed. Alternatively, configure the rule to perform the action directly without a Quick Step.

  1. Go to Home → Rules → Manage Rules & Alerts.
  2. Click New Rule.
  3. Select Apply rule on messages I receive and click Next.
  4. Choose conditions that match the emails you want to process.
  5. Select the action you want to perform automatically (for example, move to a folder or assign a category).
  6. Click Finish, then Apply, then OK.

5. Check for Conflicting Rules

Outlook rules and Quick Steps can interfere with each other, particularly when both target the same incoming messages.

  1. Go to Home → Rules → Manage Rules & Alerts.
  2. Review each rule and look for any that perform the same action as your Quick Step (for example, moving the same messages to the same folder).
  3. Temporarily disable conflicting rules by unchecking the box next to them.
  4. Click Apply, then OK.
  5. Test your Quick Step again.

6. Update Outlook

Microsoft regularly releases fixes for Outlook behaviour issues. Running an outdated version can cause Quick Steps to fail.

On Windows:

  1. Open Outlook and click File → Office Account → Update Options.
  2. Select Update Now.

On Mac:

  1. Open Outlook and click Help in the menu bar.
  2. Select Check for Updates.
  3. This opens the Microsoft AutoUpdate tool. Click Update.

7. Clear the Outlook Cache

A stale cache can prevent Quick Steps from executing properly on new mail.

On Windows:

  1. Close Outlook.
  2. Press Win + R, type %LOCALAPPDATA%\Microsoft\Outlook\RoamCache, and press Enter.
  3. Select all files in the folder and delete them.
  4. Restart Outlook.

On Mac:

  1. Quit Outlook.
  2. Open Finder and press Cmd + Shift + G.
  3. Type ~/Library/Containers/com.microsoft.Outlook/Data/Library/Caches and press Return.
  4. Move the contents of the folder to Trash, then empty the Trash.
  5. Restart Outlook.

8. Repair or Recreate Your Outlook Profile

If the issue continues, your Outlook profile may be corrupted. Outlook includes a profile repair tool, but in stubborn cases, creating a fresh profile is more effective.

Repair the existing profile:

  1. Close Outlook.
  2. Open the Control Panel and search for Mail (Microsoft Outlook).
  3. Click Show Profiles, select your profile, then click Properties.
  4. Click Email Accounts, select your account, then click Repair.
  5. Follow the prompts and restart Outlook.

Create a new profile:

  1. In the Mail control panel, click Show Profiles → Add.
  2. Enter a name for the new profile and follow the prompts to add your email account.
  3. Set the new profile as the default if desired.
  4. Open Outlook and reconfigure your Quick Steps.
Quick Steps are tied to your Outlook profile. They do not roam between profiles or devices. When you create a new profile, you must recreate your Quick Steps manually. Local data files (.pst) remain intact, but cached Exchange data (.ost) will need to resynchronise, which may take some time depending on mailbox size.

Troubleshooting

Quick Step runs manually but not automatically on incoming mail

This is expected behaviour. Quick Steps are manual actions and do not process incoming mail automatically unless combined with a rule. Follow Step 4 to set up a rule for automatic processing, or apply the Quick Step manually to selected messages.

Quick Step shows an "Operation failed" error

This typically points to a corrupted data file. Run the repair steps in Step 2, then clear the cache using Step 7.

Quick Steps are missing from the ribbon

The Quick Steps gallery may have been collapsed. Click the small arrow at the right edge of the Quick Steps group on the Home tab to expand it. If the entire group is missing, reset the ribbon by going to File → Options → Customise Ribbon and clicking Reset.

Quick Steps work on some accounts but not others

This suggests the issue is profile-specific rather than an Outlook-wide fault. Try repairing or recreating the profile associated with the affected account, as outlined in Step 8.

Quick Steps stopped working after a recent Office update

Microsoft occasionally releases updates that affect add-ins and automation features. Recreate the affected Quick Step using Step 3, and ensure Outlook is fully updated using Step 6.

If you have completed all steps above and your Quick Steps still do not work on incoming emails, contact our support team for further assistance.

Open a Ticket

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket