Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add info about adapted plugins to troubleshooting guide #623

Merged
merged 1 commit into from
Mar 14, 2025
Merged

Add info about adapted plugins to troubleshooting guide #623

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,22 @@ please open a new issue.

## Known issues

### Installed plugin doesn't show up in `Plugins` menu

Installed `npe2` plugins (this is most plugins!) are not loaded until you restart `napari`. Try restarting the viewer
and see whether this resolves your issue.

### Plugin options missing

If you've installed a plugin, restarted `napari`, and some of the plugin's options are missing e.g. there is no `Tools`
menu or you're trying to save layers and can't find the plugin in the listed writers, you might have an auto-converted
plugin using the deprecated `npe1` engine.

Try turning off the `Use npe2 adaptor` setting under `Preferences -> Plugins -> Use npe2 adaptor` and restarting napari.
This setting will be removed in version `0.7.0` of napari, so reach out to the plugin developer to update their plugin.

Learn more about this in the [adapted plugin guide](adapted-plugin-guide).

### Resetting preferences and settings

Changing napari versions—updating or downgrading—within an environment can cause issues with settings. These issues can
Expand Down