🎉 Release v0.21.1

[wpxp123456]

🎊 Univer@v0.21.1

🚧 Important Note

Univer Sheets features are becoming more stable, and we are planning for the release of version 1.0.
If you have any suggestions, please submit them in our issues to help us shape the future of Univer.

🚀 Getting Started

If you're eager to explore Univer, check out our getting started documentation.
Dive into the world of collaborative document, spreadsheet, and presentation editing powered by Univer!

📊 Univer Sheets

💔 Breaking Changes

• Refactor the API related to defined names: univerAPI.newDefinedName has been replaced with FWorkbook.newDefinedNameBuilder. refactor: refactor and add validation for the definedName API #6826

🐛 Bug Fixes and Optimizations

• Fix the issue of PermissionService not registered when removing protected ranges. fix: fix handleWorksheetRangePermissionIsEmpty error #6821
• Fix the issue of not validating the legality of names when adding defined names through API. refactor: refactor and add validation for the definedName API #6826
• Optimize the DOM performance and related algorithm performance of list rendering in scenarios with a large number of defined names. fix(definedName): optimize performance issues related to defined name #6829
• Fix the issue of ClearSelectionContentCommand execution error introduced in version 0.21.0. fix(definedName): optimize performance issues related to defined name #6829
• Fix the issue of floating images in the current workbook disappearing when creating a hidden workbook. fix: fix the issue of drawings will remove when creating a unit with makeCurrent is false #6833
• Add .js extension to the deep import of opentype.js for compatibility with Node.js ESM. fix(engine-render): add .js extension to opentype.js deep import for Node.js ESM compatibility #6835
• Fix the issue of document is not defined error when calling FRange.setValue in a Node.js environment. fix: fix the document is not defined error that occurred when using FRange.setValue in a Node.js environment #6834
• Optimize the number extension rules in the auto-fill feature. fix(autofill): fix extend number rule of auto fill #6837
• Fix the issue of collaborator cursors being invisible in collaborative editing introduced in version 0.16.0.
• Fix the issue of the API for subscribing to changes in online personnel in the collaborative room not being triggered correctly when personnel leave.

Special thanks to community contributor @getmateri for contributions in this version:

• Optimize the formula bar name box to create a defined name for the workbook range based on the current selection when pressing Enter. fix(sheets-ui): restore name box range naming flow #6705
• Fix the issue of not being able to continue moving the selection with arrow keys after pressing Enter in the formula bar name box to jump to the corresponding selection. fix(sheets-ui): restore name box range naming flow #6705

🌐 Univer Server

• Fix the issue of hidden drawing elements being incorrectly displayed when importing Excel files.

📢 Join the Conversation

We welcome your input and insights as we embark on this exciting journey. Connect with us on:

• GitHub Discussions
• 👾 Discord

📝 Changelog

Full changelog (2026-04-25)

Bug Fixes

• autofill: fix extend number rule of auto fill (#6837) (8fe1122)
• conditionformat: fix condition format rule stopif true err (#6823) (79ac910)
• definedName: optimize performance issues related to defined name (#6829) (8c15220)
• drawing: fix drawing visible in import (#6822) (e84d694)
• engine-render: add .js extension to opentype.js deep import for Node.js ESM compatibility (#6835) (8c226ed)
• fix handleWorksheetRangePermissionIsEmpty error (#6821) (da009a8)
• fix the document is not defined error that occurred when using FRange.setValue in a Node.js environment (#6834) (0b1ac31)
• fix the issue of drawings will remove when creating a unit with makeCurrent is false (#6833) (efb3980)
• scroll: gap config (#6828) (48fb4c2)
• scroll: initial for gap zero (#6832) (6e8f767)
• sheets-ui: fix incorrect JSDoc for attachRangePopup (#6824) (dba94e9)
• sheets-ui: restore name box range naming flow (#6705) (38eec33)

---

This discussion was created from the release 🎉 Release v0.21.1.

[wpxp123456]

🎊 Univer@v0.21.1

🚧 重要提示

Univer Sheets 的各项功能正趋于稳定，我们正在计划 release 1.0。如果你有任何建议，欢迎在issues 提交，帮助我们塑造 Univer 的未来。

🚀 快速开始

如果您希望了解 Univer，请查看我们的入门文档。
深入探索由 Univer 提供支持的协作文档、电子表格和演示文稿编辑的世界！

📊 Univer Sheets

💔 破坏性更新

• 重构定义名称部分 API：univerAPI.newDefinedName 已替换为 FWorkbook.newDefinedNameBuilder。refactor: refactor and add validation for the definedName API #6826

🐛 改进与优化

• 修复移除保护范围时报 PermissionService 未注册的问题。fix: fix handleWorksheetRangePermissionIsEmpty error #6821
• 修复通过 API 添加定义名称时未校验名称合法性的问题。refactor: refactor and add validation for the definedName API #6826
• 优化大量定义名称场景下列表渲染的 DOM 性能和相关算法性能。fix(definedName): optimize performance issues related to defined name #6829
• 修复 0.21.0 版本引入的 ClearSelectionContentCommand 执行报错问题。fix(definedName): optimize performance issues related to defined name #6829
• 修复创建隐藏工作簿时，当前工作簿浮动图片消失的问题。fix: fix the issue of drawings will remove when creating a unit with makeCurrent is false #6833
• 为 opentype.js 的 deep import 补充 .js 扩展名，以兼容 Node.js ESM。fix(engine-render): add .js extension to opentype.js deep import for Node.js ESM compatibility #6835
• 修复 Node.js 环境下调用 FRange.setValue 报 document is not defined 的问题。fix: fix the document is not defined error that occurred when using FRange.setValue in a Node.js environment #6834
• 优化自动填充功能中的数字扩展规则。fix(autofill): fix extend number rule of auto fill #6837
• 修复 0.16.0 版本引入的协同编辑中协作者光标不可见的问题。
• 修复订阅协同房间在线人员变更的 API 在人员离开时未正确触发的问题。

感谢社区贡献者 @getmateri 对此次版本的贡献：

• 优化公式栏名称框在按下 Enter 时根据当前选区创建工作簿范围的定义名称。fix(sheets-ui): restore name box range naming flow #6705
• 修复公式栏名称框在按下 Enter 键跳转到对应选区后，无法通过方向键继续移动选区的问题。fix(sheets-ui): restore name box range naming flow #6705

🌐 Univer Server

• 修复导入 Excel 文件时，隐藏的 drawing 元素被错误显示的问题。

📢 加入讨论

我们欢迎您的参与和见解，一起踏上这个激动人心的旅程。请通过以下方式与我们联系：

• GitHub Discussions
• 👾 Discord

📝 更新日志

完整的更新日志 (2026-04-25)