yazi breaking changes

homebrew

11 curated breaking changes across major versions of yazi. Use this as a migration checklist before bumping dependencies.

11
changes
Breaking changes by transition
  • v25.4.8 \u2192 v25.5.28breaking

    `[manager]` is deprecated in favor of the new `[mgr]`. https://github.com/sxyazi/yazi/pull/2803

  • v25.4.8 \u2192 v25.5.28breaking

    `tab_width` has been removed as it no longer needs to be set manually. https://github.com/sxyazi/yazi/pull/2745

  • v25.4.8 \u2192 v25.5.28breaking

    `tab_active` and `tab_inactive` are moved under the new `[tabs]` section. https://github.com/sxyazi/yazi/pull/2745

  • v25.4.8 \u2192 v25.5.28breaking

    `sixel_fraction` has been removed as it's no longer needed. https://github.com/sxyazi/yazi/pull/2707

  • v25.3.2 \u2192 v25.4.8breaking

    Supported wraparound navigation and enabled it by default. https://github.com/sxyazi/yazi/pull/2485

  • v25.3.2 \u2192 v25.4.8breaking

    Replaced `tasks_show` and `close_input` with `tasks:show` and `input:close`. https://github.com/sxyazi/yazi/pull/2530

  • v25.3.2 \u2192 v25.4.8breaking

    `frag`, `name`, `stem`, `ext`, and `parent` on [`Url`](https://yazi-rs.github.io/docs/plugins/types#shared.url), `name` on [`tab::Tab`](https://yazi-rs.github.io/docs/plugins/types#app-data.tab-tab), and `is_hovered` on [`fs::File`](https://yazi-rs.github.io/docs/plugins/types#app-data.fs-file) are now properties. https://github.com/sxyazi/yazi/pull/2572

  • v25.3.2 \u2192 v25.4.8breaking

    Swapped the default key bindings for `z` (zoxide) and `Z` (fzf). https://github.com/sxyazi/yazi/issues/2546

  • v25.3.2 \u2192 v25.4.8breaking

    Used the new `@sync peek` annotation instead of the previewer's `sync = true`. https://github.com/sxyazi/yazi/pull/2487

  • v25.2.11 \u2192 v25.2.26breaking

    `separator_open` and `separator_close` have been replaced with the new `sep_left` and `sep_right`. https://github.com/sxyazi/yazi/pull/2313

  • v25.2.11 \u2192 v25.2.26breaking

    The `[completion]` component has been renamed to `[cmp]`. https://github.com/sxyazi/yazi/pull/2399

API access

Get this data programmatically \u2014 free, no authentication.

curl https://depscope.dev/api/breaking/homebrew/yazi
yazi breaking changes — Homebrew migration guide | DepScope