Flow Launcher Crashes: Capture a Minimal Reproduction

Troubleshooting · Published October 30, 2026 · Publisher: flowlauncher.app

At a glance

A useful crash diagnosis identifies the action that causes Flow Launcher to exit or show an exception. Preserve your configuration, record the exact error, and separate plugin, theme, and base-app behavior. Reinstalling immediately can remove the evidence needed to find the cause.

Steps to follow

  1. Write down the exact sequence before the crash, including the query and source plugin when known.
  2. Record Flow version, Windows build, and recent changes such as a plugin update or theme import.
  3. Back up UserData and reproduce with the implicated plugin disabled or with a built-in theme, changing only one factor at a time.
  4. Follow the project issue template or the plugin maintainer’s reporting instructions with a minimal non-sensitive example.

Check the result

The crash can be reproduced with a short sequence, or you have isolated the recent component change that triggers it.

Limits and common pitfalls

Logs and exception text can reveal private paths and query data. Redact secrets while preserving the meaningful error type and stack information.

Make the check repeatable

A minimal reproduction is not the same as a full copy of your workstation. Use a harmless filename, a temporary folder, and a basic query where possible. Keep the original profile available so you can confirm whether a proposed fix resolves the same symptom rather than a different configuration.

Questions and answers

Should plugin crashes be reported to the Flow project?

Start with the component identified by the error. The project support guide notes that third-party plugin issues may belong in the plugin’s repository.

Sources and scope

Documentation-based guidance, with source review on October 30, 2026. What was and was not tested.

Related guides