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.

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. Run Outlook's built-in repair tool on your mailbox.
  3. Recreate the affected Quick Step from scratch.
  4. Check for conflicting Outlook rules that may be blocking the Quick Step.
  5. Update Outlook to the latest version.

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. Run the Inbox Repair Tool (ScanPST) on Windows

Corrupted Outlook data files (.pst or .ost) are a common cause of Quick Step failures.

  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.
On Microsoft 365 accounts, your data file is typically an .ost file located in the path above. On POP/IMAP accounts, it will be a .pst file.

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 top-right corner to open the Quick Steps gallery.
  3. Click Create New.
  4. Choose a starting action (for example, Move to folder) from the dropdown.
  5. Configure the action exactly as the original Quick Step was set up.
  6. Click Finish.
  7. Test the new Quick Step on an incoming email.
If you have many Quick Steps and cannot remember the original configuration, you can export your Quick Steps first. Go to FileOptionsMail and click Export under the Quick Steps section.

4. Check for Conflicting Rules

Outlook rules and Quick Steps can interfere with each other, particularly when both target the same incoming messages. For a detailed walkthrough on managing rules, see Organising Emails with Rules and Alerts in Outlook.

  1. Go to HomeRulesManage 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.

5. 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 FileOffice AccountUpdate 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.

6. 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.

7. 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 ProfilesAdd.
  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.
When creating a new profile, your local data files (.pst) remain intact, but cached Exchange data (.ost) will need to resynchronise. This may take some time depending on mailbox size.

Troubleshooting

Quick Step runs manually but not automatically on incoming mail

This usually indicates a rule conflict or a corrupted Quick Step. Follow Step 3 to recreate the Quick Step, then check for conflicting rules using Step 4.

Quick Step shows an "Operation failed" error

This typically points to a corrupted data file. Run the Inbox Repair Tool as described in Step 2, then clear the cache using Step 6.

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 FileOptionsCustomise 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 7.

Quick Steps stopped working after a recent Office update

Microsoft occasionally releases updates that affect Quick Step behaviour. Check the Office release notes for any known issues, and ensure you have installed the latest cumulative updates. If the problem began immediately after an update, you can roll back to the previous version of Office via FileOffice AccountUpdate OptionsView Update History, or use the Microsoft Support and Recovery Assistant to diagnose the issue further.

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