# Yazi v26.5.6

- Product: Yazi (https://whatsnew.fyi/product/yazi)
- Vendor: yazi-rs
- Date: 2026-05-05
- Version: v26.5.6
- Original notes: https://github.com/sxyazi/yazi/releases/tag/v26.5.6
- Permalink: https://whatsnew.fyi/product/yazi/releases/v26.5.6
- Labels: Platforms: Desktop

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Custom tab name
- **added** — New `--in` for `search` action to set search directory
- **added** — Hover cursor over the new file after copying/cutting/linking/hardlinking/extracting
- **added** — Drag-resize panes with mouse
- **added** — Multi-file spotter
- **added** — New `app:theme` action that hot-reload user themes/flavors
- **added** — Dynamic open/opener Lua API
- **added** — Dynamic previewer Lua API
- **added** — Custom styles for plugins
- **added** — Vim-like `lua` action that runs an inline Lua snippet
- **added** — Certificate authentication for SFTP VFS provider
- **added** — New `hovered` condition specifying different icons for hovered files
- **added** — Allow using `ps.sub()` in `init.lua` directly without a plugin
- **added** — New `ya.exec()` API and `ya exec` subcommand to execute an action and await its result
- **added** — New `sort_fallback` option to control fallback sorting behavior
- **added** — New `fs.access()` API to access the filesystem
- **added** — New `relay-notify-push` DDS event to customize the notification handler
- **added** — New `ind-app-title` DDS event to customize the app title
- **added** — New `ind-hidden` and `key-hidden` DDS events to change hidden status in Lua
- **added** — New `marker_symbol` option to specify the symbol used for marking files
- **added** — New `--discard` for `ya pkg` that discard local changes made to packages
- **changed** — Upgrade Lua to 5.5
- **changed** — Change preset <kbd>t</kbd> for creating tabs to <kbd>t</kbd> ⇒ <kbd>t</kbd> to avoid conflict with new <kbd>t</kbd> ⇒ <kbd>r</kbd> for renaming tabs
- **changed** — Make `ui.Style` immutable
- **changed** — Remove `title_format` in favor of new `ind-app-title` DDS event for flexible title customization
- **changed** — Remove `micro_workers` and `macro_workers` in favor of finer control over concurrent workers
- **changed** — Rename `id` of the fetcher rule to `group`
- **deprecated** — Deprecate `fs.unique_name()` in favor of `fs.unique()` to fix a TOCTOU race condition
- **fixed** — Chafa v1.18.1 causes random ghost keypresses when previewing images
- **fixed** — `paste --force` doesn't work on existing read-only files with the same name
- **fixed** — Be a little defensive while parsing the output of `7zz -ba`
- **fixed** — Make `ya pkg` ignore default remote name in user Git config
- **fixed** — Archive extraction fails for target paths with non-ASCII characters on Windows
- **fixed** — Escape backslashes in ImageMagick font path parameter

###### Added

- Custom tab name ([#3666])
- New `--in` for `search` action to set search directory ([#3696])
- Hover cursor over the new file after copying/cutting/linking/hardlinking/extracting ([#3846], [#3854])
- Drag-resize panes with mouse ([#3890])
- Multi-file spotter ([#3733])
- New `app:theme` action that hot-reload user themes/flavors ([#3906])
- Dynamic open/opener Lua API ([#3901])
- Dynamic previewer Lua API ([#3891])
- Custom styles for plugins ([#3934])
- Vim-like `lua` action that runs an inline Lua snippet ([#3813])
- Certificate authentication for SFTP VFS provider ([#3716])
- New `hovered` condition specifying different icons for hovered files ([#3728])
- Allow using `ps.sub()` in `init.lua` directly without a plugin ([#3638])
- New `ya.exec()` API and `ya exec` subcommand to execute an action and await its result ([#3780])
- New `sort_fallback` option to control fallback sorting behavior ([#3077])
- New `fs.access()` API to access the filesystem ([#3668])
- New `relay-notify-push` DDS event to customize the notification handler ([#3642])
- New `ind-app-title` DDS event to customize the app title ([#3684])
- New `ind-hidden` and `key-hidden` DDS events to change hidden status in Lua ([#3748])
- New `marker_symbol` option to specify the symbol used for marking files ([#3689])
- New `--discard` for `ya pkg` that discard local changes made to packages ([#3781])
- New `bulk_exit` action that customizes the prompt for bulk operations ([#3792])
- New `fs.unique()` creates a unique file or directory ([#3677])
- New `download` DDS event fires when remote files are downloaded ([#3687])
- New `ind-which-activate` DDS event to change the which component behavior ([#3608])
- New `hey` DDS event fires when static messages are restored from persistence ([#3725])
- New `cx.which` API to access the which component state ([#3617])
- New experimental `ya.co()` API that creates a coroutine ([#3757])

###### Changed

- Upgrade Lua to 5.5 ([#3633])
- Change preset <kbd>t</kbd> for creating tabs to <kbd>t</kbd> ⇒ <kbd>t</kbd> to avoid conflict with new <kbd>t</kbd> ⇒ <kbd>r</kbd> for renaming tabs ([#3666])
- Make `ui.Style` immutable ([#3862])
- Remove `title_format` in favor of new `ind-app-title` DDS event for flexible title customization ([#3684])
- Remove `micro_workers` and `macro_workers` in favor of finer control over concurrent workers ([#3661])
- Rename `id` of the fetcher rule to `group` ([#3943])

###### Deprecated

- Deprecate `fs.unique_name()` in favor of `fs.unique()` to fix a TOCTOU race condition ([#3677])

###### Fixed

- Chafa v1.18.1 causes random ghost keypresses when previewing images ([#3678])
- `paste --force` doesn't work on existing read-only files with the same name ([#3894])
- Be a little defensive while parsing the output of `7zz -ba` ([#3744])
- Make `ya pkg` ignore default remote name in user Git config ([#3648])
- Archive extraction fails for target paths with non-ASCII characters on Windows ([#3607])
- Escape backslashes in ImageMagick font path parameter ([#3708])

###### Improved

- Reduce memory allocations by using Lua 5.5 external strings ([#3634])
- Reuse previewed and spotted widgets when possible ([#3765])
- Avoid unnecessary allocations in code highlighting ([#3804])