How to Reset Quick Look Cache and Reload Generators on Mac Using qlmanage

Quick Look is one of the most productive features in macOS, allowing users to select any file in Finder and press the Spacebar to view rich, high-resolution document previews, play media clips, inspect code syntax, and review vector graphics without launching heavyweight applications. Quick Look achieves this speed by caching generated thumbnail assets and relying on modular system plugins called Quick Look Generators (.qlgenerator).

However, over months of continuous use—or after installing software updates, image editing suites, and 3D rendering packages—Quick Look can develop defects. Common symptoms include blank grey preview cards, outdated thumbnail images that fail to reflect recent edits, or crashing preview windows. The standard macOS command-line utility qlmanage allows users and administrators to test, diagnose, reset, and reload Quick Look subsystems directly from Terminal.

Flushing and Resetting the Quick Look Thumbnail Cache

If Finder displays incorrect, blurry, or missing thumbnails for updated files, clearing the corrupted thumbnail database is the first corrective step:

1. Open the Terminal application on your Mac (press Cmd + Space, type Terminal, and press Enter).
2. Execute the cache reset command:

   qlmanage -r cache

3. Terminal will return a confirmation message: qlmanage: Reseting quicklookd cache.
4. To ensure that Finder immediately purges stale in-memory thumbnails and regenerates fresh previews, restart the Finder process:

   killall Finder

Reloading Quick Look Generators and Plugins

When you install or remove third-party Quick Look plugins (such as QLMarkdown, QuickLookJSON, or SyntaxHighlight) located in /Library/QuickLook/ or ~/Library/QuickLook/, the Quick Look daemon must reload its generator registry:

qlmanage -r

This command instructs the background quicklookd daemon to rescan all system and user plugin directories, register newly installed file type handlers, and discard uninstalled plugin associations.

Auditing Installed Quick Look Generators

To inspect which generator handles a specific file format on your Mac:

qlmanage -m plugins

This outputs an exhaustive mapping of Uniform Type Identifiers (UTIs) to their corresponding generator bundles. To search for a specific file extension (such as PDF or SVG):

qlmanage -m plugins | grep -i "pdf"

Testing and Generating File Previews in Terminal

If a file consistently fails to open when tapping the Spacebar in Finder, you can test whether the Quick Look daemon can render it directly from the command line:

• Opening a Floating Preview Window:

  qlmanage -p document.docx

  This command spawns an isolated Quick Look window rendering the specified document, outputting detailed diagnostic error traces to Terminal if the rendering engine fails.
• Generating a Standalone Thumbnail Image:

  qlmanage -t -s 512 -o /tmp/ design_mockup.psd

  The -t flag instructs qlmanage to generate a thumbnail, -s 512 specifies a 512-pixel resolution, and -o /tmp/ outputs the rendered thumbnail as a PNG file into your /tmp directory for visual inspection.