How to fix Mac Quick Look not working or previewing files on macOS
Summary
This guide helps you troubleshoot and resolve: How to fix Mac Quick Look not working or previewing files on macOS. Follow the steps below to fix the issue.
Common Causes
Quick Look is a built-in macOS feature that lets you preview files and documents by selecting them in Finder and pressing the Space bar. When it stops working, files may appear blank, fail to load, or refuse to generate thumbnails. In most cases, the issue is caused by a corrupted preview cache or a stuck Quick Look process, both of which can be resolved without affecting your personal files.
Before You Begin: Identify Your Mac Processor
Safe Mode instructions differ depending on whether your Mac uses an Intel processor or Apple Silicon. Identify your processor before proceeding:
- Click the Apple menu in the top-left corner of the screen.
- Select About This Mac.
- Look at the Chip or Processor line.
- If it says Apple M1, Apple M2, Apple M3, or similar, you have an Apple Silicon Mac.
- If it says Intel Core i5, Intel Core i7, or similar, you have an Intel-based Mac.
Quick Fix Steps
If Quick Look has stopped responding or previews are failing, try these steps in order before moving to the detailed instructions below.
- Select the file in Finder and press
Spaceto test whether Quick Look is responding. - Quit and reopen Finder using
Option+ Right-click the Finder icon in the Dock, then choose Relaunch. - Force quit the Quick Look process via Activity Monitor.
- Rebuild the Quick Look cache using Terminal.
- Restart your Mac in Safe Mode to clear stuck system caches.
Detailed Instructions
Step 1: Relaunch Finder
Finder occasionally holds onto a broken Quick Look state. Relaunching it forces macOS to reload the preview service.
- Locate the Finder icon in the Dock.
- Hold
Optionand right-click (or Control-click) the Finder icon. - Select Relaunch from the context menu.
- Try selecting a file and pressing
Spaceagain.
Step 2: Force Quit the Quick Look Process
If relaunching Finder does not resolve the issue, the Quick Look background process (qlmanage) may be stuck.
- Open Activity Monitor from Applications > Utilities, or search for it using Spotlight (
Cmd+Space). - In the search field, type
qlmanage. - Select the
qlmanageprocess from the list. - Click the X button in the toolbar.
- Choose Force Quit when prompted.
- Test Quick Look again by selecting a file and pressing
Space.
qlmanage entries. Force quit each one individually to fully reset the service.Step 3: Rebuild the Quick Look Cache
macOS stores preview thumbnails in a cache folder. If this cache becomes corrupted, previews may fail to generate or appear blank. Rebuilding it forces macOS to regenerate previews from scratch.
- Open Terminal from Applications > Utilities.
- Type the following command and press
Return:qlmanage -r - Wait for the command to finish. You may see several lines of output as the cache is reset.
- Close Terminal and test Quick Look in Finder.
qlmanage -r command resets the Quick Look cache for the current user. Your actual files are not modified or deleted.Step 4: Manually Clear the Quick Look Cache
If the command above does not resolve the issue, you can delete the cache files manually.
- Open Finder and click Go in the menu bar.
- Hold
Optionand select Library from the dropdown menu. This reveals the hidden user Library folder. - Navigate to
Caches/com.apple.QuickLook.thumbnailcache. - Move the contents of this folder to the Trash.
- Empty the Trash and restart your Mac.
~/Library folder. Only delete the contents of the Quick Look thumbnail cache folder, and avoid modifying or moving any other files or subfolders.Step 5: Restart in Safe Mode
Safe Mode clears certain system caches and disables third-party extensions, which can help identify whether background software is interfering with Quick Look.
Intel-based Macs
- Click the Apple menu and choose Shut Down.
- Wait at least 10 seconds for the Mac to fully power off.
- Press the Power button, then immediately hold
Shift. - Release
Shiftwhen you see the login window. - Log in and test Quick Look by selecting a file and pressing
Space. - Restart your Mac normally to exit Safe Mode.
Apple Silicon Macs
- Click the Apple menu and choose Shut Down.
- Wait at least 10 seconds for the Mac to fully power off.
- Press and hold the Power button until you see Loading startup options.
- Click Options, then click Continue.
- Hold
Shiftand click Continue in Safe Mode. - Log in and test Quick Look by selecting a file and pressing
Space. - Restart your Mac normally to exit Safe Mode.
Troubleshooting
Quick Look Works for Some Files but Not Others
If Quick Look previews work for images but not for documents, spreadsheets, or PDFs, the relevant preview extension may be missing or corrupted.
- For PDFs, ensure Preview is installed. To set it as the default PDF viewer, select a PDF in Finder, press
Cmd+Ito open Get Info, expand Open with, choose Preview, then click Change All. - For Microsoft Office files, install or repair Microsoft Office or Microsoft 365, as Quick Look relies on these apps for document previews.
- For proprietary file types, ensure the originating application is installed. Quick Look cannot preview formats it does not recognise.
Third-Party Quick Look Plugins
Third-party Quick Look generators installed in system or user library folders can conflict with built-in previews and cause Quick Look to fail.
- Open Finder.
- Click Go in the menu bar, then hold
Optionand select Library. - Check the
/Library/QuickLookfolder for installed Quick Look generator components. - Check the
~/Library/QuickLookfolder for user-specific Quick Look plugins. - Move any suspect or outdated plugin files to the Trash.
- Empty the Trash and restart your Mac.
- Test Quick Look again. If the issue is resolved, contact the plugin developer for an updated version compatible with your macOS version.
Quick Look Opens but Shows a Blank or Black Window
A blank preview window usually indicates a graphics or rendering issue.
- Quit and reopen the affected application.
- Restart your Mac to reset the graphics stack.
- Check for macOS updates via System Settings > General > Software Update (macOS Ventura and later) or System Preferences > Software Update (macOS Monterey and earlier).
- If you use an external display, disconnect it and test Quick Look on the built-in screen.
Quick Look Crashes When Opening Specific Files
If Quick Look consistently crashes on a particular file, the file itself may be damaged.
- Try opening the file directly in its native application to confirm it is not corrupted.
- Copy the file to a different location and test the preview again.
- If the issue affects only one file, consider re-downloading or restoring it from a backup.
Quick Look Stops Working After a macOS Update
Occasionally, macOS updates can disrupt Quick Look behaviour. After a major update:
- Reboot your Mac to complete any pending update tasks.
- Run the
qlmanage -rcommand in Terminal to refresh the cache. - Install any available updates for third-party apps that provide preview extensions.
Escalation
If Quick Look still fails after completing all troubleshooting steps, the issue may be related to user account corruption or deeper system damage.
- Create a new user account via System Settings > Users & Groups (macOS Ventura and later) or System Preferences > Users & Groups (macOS Monterey and earlier), log in to the new account, and test Quick Look to determine if the problem is specific to your user profile.
- If the issue persists across all user accounts, contact your IT support provider or Apple Support for further assistance.
- Open a Ticket
Still Having Issues?
💻 Open a Ticket