Summarize the weekly product update logs, and the latest releases can be checked on our blog.
NocoBase is currently updated with three branches: main , next and develop.

main:The most stable version to date, recommended for installation;next:Beta version, contains upcoming new features and has been preliminarily tested. There might be some known or unknown issues. It’s mainly for test users to collect feedback and optimize functions further. Ideal for test users who want to experience new features early and give feedback;develop:Alpha version, contains the latest feature code, may be incomplete or unstable, mainly for internal dev and rapid iteration. Suited for tech users interested in product’s cutting-edge, but with potential issues and incomplete functions. Not for production use.
main

v2.0.41
Release date: 2026-04-22
🎉 New Features
- [Auth: OIDC] mapping attribute support custom fields by @chenzhizdt
- [DingTalk] DingTalk: notifications, in-DingTalk auto login, and user sync. by @chenzhizdt
🚀 Improvements
- [ai] AI employee and knowledge base now support additional file types for upload (.xlsx, .xls, .csv, .md, .json) (#9172) by @cgyrock
- [undefined] Add Arabic translation for guide section and navigation (#9141) by @saraTabbane
🐛 Bug Fixes
-
[data-source-manager] Fix for percentage fields being reset to numeric when resynchronizing external data sources (#9178) by @jiannx
-
[client]
-
[Departments] Fixed an issue where repeated department synchronization could not update department sort order (#9173) by @2013xile
-
[Data source: Main] Fixed field sync from database for connected views when the collection name differs from the database view name (#9155) by @2013xile
-
[Workflow: JavaScript] Fix security issue of script executing in
node:vmmode (#9084) by @mytharcher -
[AI: Knowledge base] Fix issue where vector database is not synced when deleting knowledge base documents. by @cgyrock
-
[WeCom] Fixed missing department order when synchronizing departments from WeCom by @2013xile
v2.0.40
Release date: 2026-04-20
🐛 Bug Fixes
-
[client] Fixed an issue where updating sub-table values through field assignment would result in data contamination. (#9163) by @gchust
-
[data-source-manager] Fixed an issue where sequence fields could be changed to string after database synchronization (#9143) by @2013xile
-
[File manager] Return null when preview URL is missing (#9104) by @gaston98765
-
[Workflow: JavaScript] Fix security issue of script executing in
node:vmmode (#9084) by @mytharcher -
[Departments]
v2.0.39
Release date: 2026-04-18
🚀 Improvements
- [Departments] Display the
parentIdforeign key field of department collection in the UI (#9130) by @2013xile
🐛 Bug Fixes
-
[data-source-manager] Fixed file collection field sync removing
previewfield (#9129) by @2013xile -
[client]
-
[database] Fixed SQL injection risks in recursive tree eager loading and scoped sort initialization (#9133) by @2013xile
-
[Data visualization] Fixed chart block sorting to use aliased measures and dimensions in aggregated queries (#9131) by @2013xile
-
[Collection: SQL] Fixed missing SQL validation on SQL collection updates (#9134) by @2013xile
v2.0.38
Release date: 2026-04-16
🎉 New Features
- [AI employees] Improve AI employees’ ability to parse uploaded documents (#9126) by @cgyrock
🚀 Improvements
- [logger] Add
refererinformation to request logs (#9110) by @2013xile - [undefined] Sync translated environment-variable and cluster-mode docs with the latest Chinese updates. (#9115) by @mytharcher
- [AI employees] After AI employee block selection, fill form attachment into upload area (#9127) by @cgyrock
- [Workflow: Manual node] Use
simplePaginationon workflow tasks related collections for better list performance (#9117) by @mytharcher - [Workflow: Approval] Use
simplePaginationonapprovalsandapprovalRecordscollection for better list performance by @mytharcher
🐛 Bug Fixes
-
[client]
-
[Notification: In-app message] Fix the issue where receiver select component works not correctly (#9123) by @mytharcher
-
[AI employees] Fix the issue where the baseURL settings of google-gen-ai’s LLM service does not take effect (#9107) by @cgyrock
-
[Email manager] Remove form closing prompt after email is sent successfully by @jiannx
next

v2.1.0-beta.14
Release date: 2026-04-20
🎉 New Features
- [Calendar] calendar block v2 (#9092) by @jiannx
- [AI employees] Improve AI employees’ ability to parse uploaded documents (#9126) by @cgyrock
- [Block: Tree] Add tree filter block (#9016) by @jiannx
- [Email manager] gmail supports sending emails with aliases by @jiannx
🚀 Improvements
-
[undefined]
- Add Arabic translation for guide section and navigation (#9141) by @saraTabbane
- Sync translated environment-variable and cluster-mode docs with the latest Chinese updates. (#9115) by @mytharcher
- Add Arabic translation for documentation homepage (#9043) by @gaston98765
- Added TOC consistency across localized READMEs (#9038) by @gaston98765
- Add Table of Contents to French README (#9037) by @saraTabbane
- Docs: add Arabic translation for get-started introduction pages (#9044) by @gaston98765
-
[logger] Add
refererinformation to request logs (#9110) by @2013xile -
[client] add form required verification switch (#9060) by @jiannx
-
[database] Optimize repository count queries by only enabling distinct when includes are present. (#9094) by @mytharcher
-
[Departments] Display the
parentIdforeign key field of department collection in the UI (#9130) by @2013xile -
[AI employees] After AI employee block selection, fill form attachment into upload area (#9127) by @cgyrock
-
[Workflow: Manual node] Use
simplePaginationon workflow tasks related collections for better list performance (#9117) by @mytharcher -
[Workflow: Approval] Use
simplePaginationonapprovalsandapprovalRecordscollection for better list performance by @mytharcher
🐛 Bug Fixes
-
[client]
- Fixed an issue where updating sub-table values through field assignment would result in data contamination. (#9163) by @gchust
- Fix the oversized height and width of tabs in page configuration mode (#9144) by @zhangzhonghe
- Fixed an issue where the association field component was incorrect in the field value settings. (#9063) by @gchust
- Fixed the optional options of single-select fields in field rule configuration are empty (#9119) by @jiannx
- Fixed incorrect default value settings for sub table in form. (#9087) by @gchust
- fix subtable adds many-to-many field error (#9070) by @jiannx
- Fixed an issue where the record pickup popup from a sub-table’s selection button could not correctly resolve parent item variable values. (#8996) by @gchust
-
[data-source-manager]
-
[database] Fixed SQL injection risks in recursive tree eager loading and scoped sort initialization (#9133) by @2013xile
-
[undefined] Fix render error in custom resource block when resource does not exist (#9095) by @Molunerfinn
-
[utils] Add security control for server HTTP request sending, to avoid possible SSRF (#9079) by @mytharcher Reference: Environment variables
-
[flow-engine]
-
[Data source: Main] Fixed field sync from database for connected views when the collection name differs from the database view name (#9155) by @2013xile
-
[File manager] Return null when preview URL is missing (#9104) by @gaston98765
-
[Departments]
-
[Workflow: JavaScript] Fix security issue of script executing in
node:vmmode (#9084) by @mytharcher -
[Collection: SQL] Fixed missing SQL validation on SQL collection updates (#9134) by @2013xile
-
[Data visualization] Fixed chart block sorting to use aliased measures and dimensions in aggregated queries (#9131) by @2013xile
-
[Notification: In-app message] Fix the issue where receiver select component works not correctly (#9123) by @mytharcher
-
[AI employees] Fix the issue where the baseURL settings of google-gen-ai’s LLM service does not take effect (#9107) by @cgyrock
-
[Notification manager] Optimize in-app notification sending performance in workflow scenarios (#9066) by @mytharcher
-
[Access control] Fixed an issue where clearing relation values with an empty array could fail under ACL (#9059) by @2013xile
-
[Collection field: Code] Correct the UI interface of the code fields (#9061) by @2013xile
-
[Email manager] Remove form closing prompt after email is sent successfully by @jiannx

v2.1.0-alpha.20
Release date: 2026-04-20
🎉 New Features
- [Workflow] Add log field for jobs, in order to show log content of some node for debug (#9165) by @mytharcher
🚀 Improvements
- [undefined] Add Arabic translation for guide section and navigation (#9141) by @saraTabbane
- [cli] Improved generated API CLI help output and ACL command grouping (#9166) by @2013xile
🐛 Bug Fixes
- [client] Fixed an issue where updating sub-table values through field assignment would result in data contamination. (#9163) by @gchust
- [data-source-manager] Fixed an issue where sequence fields could be changed to string after database synchronization (#9143) by @2013xile
- [cli] Fixed CLI OAuth login failures on Windows caused by long authorization URLs (#9159) by @2013xile
- [Departments] Fixed missing or stale main department values after saving user departments (#9156) by @2013xile
- [Data source: Main] Fixed field sync from database for connected views when the collection name differs from the database view name (#9155) by @2013xile
- [File manager] Return null when preview URL is missing (#9104) by @gaston98765
v2.1.0-alpha.19
Release date: 2026-04-19
🎉 New Features
- [cli-v1] resolve storage path from env (#9147) by @chenos
- [Calendar] calendar block v2 (#9092) by @jiannx
🚀 Improvements
- [cli] Improved
nb apihelp fallback and unified warning messages for runtime bootstrap failures (#9153) by @2013xile - [Departments] Display the
parentIdforeign key field of department collection in the UI (#9130) by @2013xile
🐛 Bug Fixes
- [client] Fix the oversized height and width of tabs in page configuration mode (#9144) by @zhangzhonghe
- [database] Fixed SQL injection risks in recursive tree eager loading and scoped sort initialization (#9133) by @2013xile
- [Workflow: JavaScript] Fix security issue of script executing in
node:vmmode (#9084) by @mytharcher - [IdP: OAuth] Fixed OAuth client registration and token refresh failures after service restart (#9139) by @2013xile
- [Departments] Fixed department lists in department management not following the
sortfield order (#9150) by @2013xile - [Collection: SQL] Fixed missing SQL validation on SQL collection updates (#9134) by @2013xile
- [Data visualization] Fixed chart block sorting to use aliased measures and dimensions in aggregated queries (#9131) by @2013xile
v2.1.0-alpha.18
Release date: 2026-04-17
🐛 Bug Fixes
- [data-source-manager] Fixed file collection field sync removing
previewfield (#9129) by @2013xile
v2.1.0-alpha.17
Release date: 2026-04-17
🎉 New Features
- [cli] refactor NocoBase CLI (#9122) by @chenos
- [AI employees] Improve AI employees’ ability to parse uploaded documents (#9126) by @cgyrock
🚀 Improvements
-
[undefined]
-
[logger] Add
refererinformation to request logs (#9110) by @2013xile -
[client] add form required verification switch (#9060) by @jiannx
-
[Workflow: Manual node] Use
simplePaginationon workflow tasks related collections for better list performance (#9117) by @mytharcher -
[AI employees] After AI employee block selection, fill form attachment into upload area (#9127) by @cgyrock
-
[Workflow: Approval] Use
simplePaginationonapprovalsandapprovalRecordscollection for better list performance by @mytharcher
🐛 Bug Fixes
-
[client]
- Fixed the optional options of single-select fields in field rule configuration are empty (#9119) by @jiannx
- Fixed an issue where the association field component was incorrect in the field value settings. (#9063) by @gchust
- Fixed incorrect default value settings for sub table in form. (#9087) by @gchust
-
[utils] Add security control for server HTTP request sending, to avoid possible SSRF (#9079) by @mytharcher Reference: Environment variables
-
[Workflow: Loop node] Fix validations of workflow nodes (#9111) by @mytharcher
-
[Notification: In-app message] Fix the issue where receiver select component works not correctly (#9123) by @mytharcher
-
[IdP: OAuth] Fixed OAuth access for regular API requests (#9120) by @2013xile
-
[AI employees]
-
[Email manager] Remove form closing prompt after email is sent successfully by @jiannx