Joplin Release Notes

• New: Add setting to hide the AI Chat toolbar button (#16607)
• Improved: AI Chat: Persist conversation history and add a chat switcher (#16583) (#16498 by @Rygaa)
• Improved: Improve how semantic search interacts with item IDs (#16652) (#16644 by @personalizedrefrigerator)
• Fixed: Fix AI configuration test failing on reasoning models (#16594)
• Fixed: Fix AppImage StartupWMClass (#16547) (#16434 by @MiQ71)
• Fixed: Fix ENEX import failing on Evernote's unescaped ampersands (#16580)
• Fixed: Fix LMStudio compatibility (#16552) (#16539 by @personalizedrefrigerator)
• Fixed: Fix dropping notes into the whiteboard editor (#16565) (#16457 by @personalizedrefrigerator)
• Fixed: Fix notes and sub-folders are still marked as published after being moved out of a published folder (#16648) (#16647 by @personalizedrefrigerator)
• Fixed: Fix reasoning blocks leaking into AI chat replies (#16595)
• Fixed: Fix sync deadlock when Joplin Server rejects an item with HTTP 422 (#16544) (#16504)
• Fixed: Fix table editor losing and mis-rendering inline markdown (#16632)
• Fixed: Fix x-callback-url responses never reaching the calling app (#16497)

AI can be useful for summarising, rewriting and asking questions about your notes. But your notes are private, so you should always know where your data is going.

Joplin does not send your notes to an AI service by default. AI features are disabled by default, and you have to explicitly enable them and choose an AI provider. Learn more about AI Chat.

Keep your notes on your own device

You can connect Joplin to a local AI model, such as Ollama or LM Studio. In this case, your notes stay within your own device or private network and are not sent to an external service.

Joplin also blocks remote AI providers by default, as an additional safeguard.

You control what AI can access

Joplin lets you choose which tools are available to AI. This applies both to AI Chat and to the Model Context Protocol (MCP) integration.

For example, you can allow an AI assistant to search your notes without giving it permission to modify them. You can enable or disable individual tools depending on what you are comfortable with.

This means that connecting an AI service to Joplin does not automatically give it unrestricted access to your data or to all of Joplin's capabilities. Learn more about MCP.

If you use a cloud AI provider

You can connect Joplin to cloud AI services such as Joplin Cloud AI, OpenAI or Anthropic. When you do, the relevant data is sent to the provider you have selected.

For AI Chat, Joplin only sends the note content required for your request — such as the currently open note or selected text — rather than automatically sending your entire notebook. Learn more about the AI Chat panel.

You are in control

Joplin's approach is simple: AI should be opt-in, transparent and configurable.

You choose whether to use AI, which provider to use, whether to use a local or remote model, and which tools that AI is allowed to access.

If you want maximum privacy, use a local AI model and only enable the tools you actually need.

Discuss on the forum

• Improved: Fix notes imported from OneNote are displayed with a very small font size (#16440) (#16424 by @Rygaa)
• Improved: Tag area broken with Japanese language (#16483) (#16427 by @Rygaa)
• Improved: Whiteboard: Double-click empty canvas to add a note (#16470)
• Fixed: Allow OpenAI reasoning models to be used with tools (#16451) (#16444)
• Fixed: Fix WebDAV sync failing with 409 errors after 3.7 upgrade (#16471) (#16422)
• Fixed: Fix keyboard navigation issues related to level-1 headings (#16409) (#16407 by @personalizedrefrigerator)
• Fixed: In-editor Markdown rendering: Fix markup syntax is visible while clicking and dragging the scrollbar (#16461) (#16454 by @personalizedrefrigerator)
• Fixed: Return 202 for MCP notification requests (#16473) (#16414)
• Fixed: Toggle AI Chat keystroke shortcut does nothing (#16433)
• Fixed: Treat private network AI providers as local and make their API key optional (#16472) (#16431)
• Fixed: Whiteboard: Add missing "Add note to whiteboard" menu item (#16468) (#16457)
• Fixed: Fix WebDAV sync error "Protocol https: not supported" on servers that redirect (#16488) (#16486)

New

• Add OrphanTrace logging to investigate orphaned items bug (#15709)

Improved

• Allow configuring the default admin password with an environment variable (#15655 by @personalizedrefrigerator)
• Allow searching emails by full name or email (8d90057)
• Display JSB banner on larger Joplin Server instances (#16255)
• Don't include dev dependencies in the built image (#15472) (#15432 by @personalizedrefrigerator)
• Enforce session and CSRF checks on the application authorisation POST (#16270)
• Give focus to MFA field when it is displayed (380401c)
• Harden user-content responses against XSS via uploaded resources (#15787)
• Hardening: Disable the proto property (#15765 by @personalizedrefrigerator)
• Improve UUID generation logic (#15656 by @personalizedrefrigerator)
• Improve items/ route validation logic (#15657 by @personalizedrefrigerator)
• Improve logging for shared notebook maintenance (#16400)
• Make LDAP login logic safer (#15707 by @personalizedrefrigerator)
• Prevent SAML login from accessing existing local password accounts (#15647)
• Prevent pending share recipients from writing items into shared folders before accepting the invitation (dff533c)
• Publishing an old note may display an error "Missing property deleted_time" (#16175) (#16132 by @Rygaa)
• Record which app screen a Joplin Cloud sign-up started from (b5ed2c9)
• Reject items with a null byte in any field (#15489)
• Scope password-reset tokens to their intended purpose (#16274)
• Silence Katex warnings (#15839)
• Speed up batch deletes by using whereIn instead of OR chains (#15705)
• Upgrade samlify to v2.13.1 (#15658 by @personalizedrefrigerator)
• Validate transcribe job ID to prevent path traversal in proxy endpoint (d97a509)

Fixed

• Allow SVG resources to be served inline (#15814) (#15802)
• Auto-unlock database after failed server migration (#15509) (#15507)
• Fix "password has not been changed" warning not shown in some cases where it should be (#15747 by @personalizedrefrigerator)
• Fix Fountain rendering issue (#15659 by @personalizedrefrigerator)
• Fix LDAP user auto-creation (#15847) (#15725 by @personalizedrefrigerator)
• Fix SQLite database getting permanently locked (#16244) (#15226 by @ivan)
• Fix orphaned items task timing out on large databases (#15704)
• Fixed LDAP connection leak when login exits early (#15855) (#15857 by @tillo)
• Fixed published notes reusing disabled owner shares (#15454) (#15373 by @Rygaa)

Improved

• Improved: Implement readonly state for mobile RTE and disable the MDE interactive table editor for readonly notes (#16231 by @mrjo118)
• Improved: Implement redesigned new note menu (#16082 by @personalizedrefrigerator)
• Improved: Implement redesigned notebook long-press menu (#16027 by @personalizedrefrigerator)
• Improved: Make the editor state update, if the current note is updated by the sync (#16150 by @mrjo118)
• Improved: Make the startup location the first entry in the navigation history instead of 'All Notes' (#16083 by @mrjo118)
• Improved: Markdown editor: Support opening same-note links to elements with id="..." attributes (#16287 by @personalizedrefrigerator)
• Improved: Prevent race which allows changes to be lost, during a long delta step (#16208 by @mrjo118)
• Improved: Prevent the remote version of a note being overwritten if typing while the sync changes the open note (#16193 by @mrjo118)
• Improved: Remove single-word titles from error/warning dialogs (#16096 by @personalizedrefrigerator)
• Improved: Support syncing with Joplin v3.7 (#15889) (#15753 by @personalizedrefrigerator)
• Improved: Sync: Enable new notebook sharing key format (#16305) (#16251 by @personalizedrefrigerator)

Fixed

• Fixed: Editor: Avoid crash when editing certain partially-loaded documents (#16286) (#16285 by @personalizedrefrigerator)
• Fixed: Fix Markdown editor selection issues (#16126) (#16070 by @personalizedrefrigerator)
• Fixed: Fix blank screen being shown when navigating back after tag changes and other edge cases (#16080) (#15265 by @mrjo118)
• Fixed: Fix empty navigation when navigating to settings from the conflicts folder after it was removed (#16197 by @mrjo118)
• Fixed: Fix inconsistent button order in profile switcher, tag screen, and deletion confirmation dialogs (#16076 by @personalizedrefrigerator)
• Fixed: Fix note screen is not properly refreshed when updated by the sync, when E2EE is enabled (#16179 by @mrjo118)
• Fixed: HTML notes: Fix certain content incorrectly renders as linked text (#16289) (#15770 by @personalizedrefrigerator)
• Fixed: Improve shadow colors in dark mode (#16326) (#16312 by @personalizedrefrigerator)
• Fixed: Mobile: When toggling a checkbox which is not at the cursor position, it will scroll away from the checkbox back to the cursor position (#16173) (#15920 by @Rygaa)
• Fixed: Prevent conflicts initially showing alongside the original note in the notebook when created (#16330) (#16155 by @mrjo118)
• Fixed: Prevent incrementing the master key updated_time when the key has not actually changed (#16223) (#16194 by @mrjo118)
• Fixed: Prevent scrolling the cursor into view on the markdown editor when unnecessary to do so (#16091) (#15923 by @mrjo118)
• Fixed: Release the save mutex when a save fails validation (#16147) (#16145 by @keshav0479)
• Fixed: Support unpublishing notes published by other users (#16246) (#16153 by @personalizedrefrigerator)

Improvements across desktop and mobile

A real table editor in the Markdown editor

Editing Markdown tables has always been the least pleasant part of writing in plain text. Joplin 3.7 adds an interactive table editor to the Markdown editor, with a context menu to add and delete rows and columns.

Because the editor is shared between platforms, this is available on mobile as well.

More reliable syncing

Syncing is faster and safer this cycle. Deleting a lot of notes at once on Joplin Server and Joplin Cloud no longer takes as long, and if you happen to be typing in a note just as it's being updated from another device, your changes are no longer at risk of being overwritten.

Faster startup

Joplin no longer processes plugin files that don't need processing at startup, which noticeably reduces launch time for users with several plugins installed.

Desktop-specific improvements

AI features (Beta)

The headline addition of this release is a set of AI features built into the app.

The chat panel sits alongside the current note and can answer questions about it, summarise it, or make edits to it on your behalf, as well as read images in your notes.

To use the AI features you need a provider, and this release introduces Joplin Cloud AI to make that as simple as possible. If you already sync with Joplin Cloud, you can simply turn it on and start using the chat panel right away - there's no API key to obtain, and nothing to configure.

If you would rather use your own provider, that remains possible: the chat panel also works with your own OpenAI or Anthropic key. It can equally be pointed at a local model running on your own machine, in which case your notes never leave your computer at all.

Semantic search is now available in the sidebar and in Go To Anything. Unlike the regular search, it matches on meaning rather than exact words, so a search for "holiday plans" can surface a note titled "Trip to Portugal".

This is powered by a new note embeddings indexer, which runs in the background and indexes both note titles and content.

Finally, all of this is available to plugin authors too. Plugins can now hold conversations with a model, run semantic searches, and work with the note index directly - which opens the door to a whole new class of plugins, from automatic tagging and summarising to tools that surface related notes as you write.

All the AI features are marked as Beta: they work, but they are new, and we expect to refine them based on how people actually use them.

MCP server

Joplin now includes an MCP server, which means external AI tools and assistants can read from and write to your notes through a standard protocol. If you already use an MCP-capable app such as Claude, it can now work directly with your Joplin data.

Whiteboards

A brand new feature on desktop: whiteboards let you arrange notes, files and free-form cards on an infinite canvas, and connect them with labelled arrows.

Notebooks and tags are good at filing things away, but they say little about how your notes relate to one another. A whiteboard gives you that missing view: you can map out a project, plan a piece of writing, or lay out the pieces of a problem and see the connections between them at a glance.

Cards and groups can be coloured, and files can be dragged and dropped straight onto the canvas.

Importing from other apps

Joplin 3.7 adds support for importing an Obsidian vault, on both desktop and the CLI, making it straightforward to move over from Obsidian while keeping your notes and their structure.

The Evernote importer now resolves cross-notebook links in many cases where they were previously lost.

The OneNote importer also received another round of fixes, in particular around note order, printouts and handwriting.

Publishing and sharing

Joplin Cloud users could already publish a note to the internet as a public page. It is now possible to publish a whole notebook at once.

The notes are published together, with their links between each other preserved, which effectively turns a notebook into a small website: a piece of documentation, a recipe collection, a set of course notes, or anything else you want to share as a whole rather than one page at a time. Anyone with the link can read it, and it stays up to date as you edit the notes in Joplin.

And when sharing a notebook, email addresses are now auto-completed, which makes sharing with the same people repeatedly much quicker.

Settings search

Joplin has accumulated a lot of settings over the years, and it is not always obvious which section holds the one you need. The configuration screen now has a search box: type what you are after, and the matching settings appear, wherever they happen to live.

Post-quantum encryption for connections

Joplin desktop now supports post-quantum cryptography (PQC) for TLS connections. This protects your synchronisation traffic against "harvest now, decrypt later" attacks, where encrypted data captured today could be decrypted by a quantum computer in the future.

Easier installation on Linux

The Linux AppImage no longer depends on the deprecated libfuse2 library. On many distributions, installing Joplin used to mean first tracking down and installing that dependency by hand - it should now simply run out of the box.

Mobile-specific improvements

The interface redesign continues

The mobile redesign that started in previous releases carries on through 3.7, this time focusing on the menus you reach for constantly - creating a note, acting on one, or long-pressing a notebook. They are now easier to read at a glance, and their options are laid out more sensibly, so common actions take less hunting. The search screen has had the same treatment.

Dialogs have been tidied up too, with buttons always appearing in the same order throughout the app - a small thing, but it means you stop having to check which side "Cancel" is on before tapping.

Faster encryption

The native crypto module has been refactored, which makes encryption and decryption substantially faster on mobile. This is most noticeable when first setting up end-to-end encryption or syncing a large collection for the first time.

Notebook sort options

You can now choose how the notebook list itself is ordered, from the configuration screen: alphabetically, or by which notebook was most recently updated - and in either direction. Sorting by recent activity is particularly handy on mobile, as it keeps the notebooks you are actually working in at the top of the sidebar.

Bug fixes and security fixes

Beyond the new features, a lot of this release went into making the apps more reliable and more secure: Joplin 3.7 includes over 100 bug fixes and eight security fixes across desktop and mobile.

For the full list of changes, see the desktop changelog and the mobile changelog.

Discuss on the forum

• Improved: Add fail-closed guardrails for locked notes (#16098) (#16054 by @keshav0479)
• Improved: Add support for unpublishing notebooks (#16237) (#16156 by @Rygaa)
• Improved: Add support to import notes from Obsidian (#16136) (#15223 by @Rygaa)
• Improved: By default, show only the editor when opening the app for the first time (#16254)
• Improved: Highlight global search matches in the Rich Text Editor (#11361) (#6088 by @personalizedrefrigerator)
• Improved: Implement readonly state for mobile RTE and disable the MDE interactive table editor for readonly notes (#16231 by @mrjo118)
• Improved: Improve chat connection check (#16256 by @personalizedrefrigerator)
• Improved: Improve refresh for whiteboards and ensure undo stack is cleared upon note refresh (#16337 by @mrjo118)
• Improved: Increase semantic search minimum relevance (#16340) (#16120 by @personalizedrefrigerator)
• Improved: Markdown editor: Support opening same-note links to elements with id="..." attributes (#16287 by @personalizedrefrigerator)
• Improved: Prevent ability to link to note or set tags for a trashed note after switching to all notes (#16320 by @mrjo118)
• Improved: Prevent race which allows changes to be lost, during a long delta step (#16208 by @mrjo118)
• Improved: Restrict Web Clipper pairing to extension origins (#16276)
• Improved: Sharing: Improve error message when public key format is unsupported (#16306 by @personalizedrefrigerator)
• Improved: Strip style elements from whiteboard card content (#16275)
• Improved: Support syncing with Joplin v3.7 (#15889) (#15753 by @personalizedrefrigerator)
• Improved: Sync: Apply changes to proxy settings immediately (#16222 by @personalizedrefrigerator)
• Improved: Sync: Enable new notebook sharing key format (#16305) (#16251 by @personalizedrefrigerator)
• Improved: Validate x-callback-url response targets (#16269)
• Fixed: Disable link to note button when note is readonly (#16238) (#15947 by @mrjo118)
• Fixed: Editor: Avoid crash when editing certain partially-loaded documents (#16286) (#16285 by @personalizedrefrigerator)
• Fixed: Fix Markdown editor selection issues (#16126) (#16070 by @personalizedrefrigerator)
• Fixed: Fix exiting having no visible effect when on the settings screen during a long sync (#16278) (#16250 by @mrjo118)
• Fixed: Fix note screen is not properly refreshed when updated by the sync, when E2EE is enabled (#16179 by @mrjo118)
• Fixed: Fix position does not always re-center when switching to a whiteboard (#16341) (#16234 by @mrjo118)
• Fixed: Fix regression which causes text to be lost if switching to another note immediately after typing in the Rich Text editor (#16213) (#16205 by @mrjo118)
• Fixed: Fix semantic search availability check (#16220) (#16219 by @personalizedrefrigerator)
• Fixed: Fix share notebook error message disappearing after half a second (f034ad2)
• Fixed: Fix sync wizard extended options are partially offscreen (#16247) (#16015 by @personalizedrefrigerator)
• Fixed: Fix toggling the chat panel clears undo/redo history (#16236) (#16007 by @personalizedrefrigerator)
• Fixed: Fix video/audio in Markdown viewer continuing to play after hiding it or switching notes (#16299) (#15278)
• Fixed: HTML notes: Fix certain content incorrectly renders as linked text (#16289) (#15770 by @personalizedrefrigerator)
• Fixed: Limit maximum size of stored OCR text (#16325) (#15890 by @personalizedrefrigerator)
• Fixed: Markdown editor: Disable table editor when opting out of in-editor rendering (#16333) (#16317 by @personalizedrefrigerator)
• Fixed: Prevent conflicts initially showing alongside the original note in the notebook when created (#16330) (#16155 by @mrjo118)
• Fixed: Prevent incrementing the master key updated_time when the key has not actually changed (#16223) (#16194 by @mrjo118)
• Fixed: Prevent password checking loop when verifying the encryption password (#16267) (#16202 by @mrjo118)
• Fixed: Rich Text Editor: Fix error while saving changes (#16307 by @personalizedrefrigerator)
• Fixed: Rich Text Editor: Save note changes after changing formatting (#16308) (#12811 by @personalizedrefrigerator)
• Fixed: Show a warning icon when a sync completes with errors (#16279) (#15258 by @mrjo118)
• Fixed: Support unpublishing notes published by other users (#16246) (#16153 by @personalizedrefrigerator)