Univer 1.0 is here. This release brings six editors—Sheets, Docs, Slides, Boards, Bases, and PDFs—into one programmable Office SDK, with shared plugin and command systems and Facade APIs for each editor.
Alongside the new editors, 1.0 improves large spreadsheet calculation, long document layout, Office file compatibility, and mobile editing. The new Server SDK and AI SDK extend integration to backend services and agents.
Read the announcement · Try Univer Office · Browse the documentation
Upgrading from 0.25? This is a major release with API removals and package changes. Read Breaking changes and migration before updating.
Highlights
Six editors, one integration model
Choose the editors your application needs and connect them to your own navigation, accounts, and business data.
| Editor | What's new in 1.0 |
|---|---|
| Sheets | A reorganized formula engine, 3D and cross-workbook references, formula-linked shapes, expanded pivot table analysis, and PivotCharts. |
| Docs | Modern and traditional editing modes, improved sections and pagination, tables of contents, footnotes, content controls, LaTeX, and calculated inline formulas. |
| Slides | A rebuilt editing workflow with masters, layouts, tables, charts, editable SmartArt, and presentation mode. |
| Boards | A new canvas for diagrams and mind maps, with shapes, connectors, containers, and Mermaid import. |
| Bases | A new structured data workspace with grid, kanban, calendar, and Gantt views, linked records, hierarchies, pivot views, and dashboards. |
| PDFs | A new PDF viewer and editor with page management, text, images, tables, annotations, export, and printing. |
Sheets also improves Excel compatibility for structured references, array formulas, implicit intersection, and date systems. Charts gain histograms, treemaps, sunburst and gauge charts, multilevel category axes, and SVG export. See the formula and chart guides.
Embed documents and keep them editable
Embed a spreadsheet in a document and continue editing its cells and formulas, or embed a board in a slide and keep its diagram tools available. Documents can also appear as workbook tabs, entries in slide page lists, or entries in Bases table lists.
Embedded documents retain their own data models and are linked by reference. Applications save each document separately. See the embedding guide for supported combinations and integration details.
Mobile editing
Sheets, Docs, Slides, Boards, and Bases gain touch-oriented editing interfaces, with adapted toolbars, property panels, navigation, and on-screen keyboard behavior. Integrate each editor's mobile UI plugins; desktop and mobile use the same document models.
Web, server, and agent workflows
- Web SDK: Embed editors and extend them through plugins, themes, and Facade APIs.
- Server SDK: Integrate collaboration and file conversion with your backend, identity, permissions, and storage.
- AI SDK: Build Office CLI and agent workflows in TypeScript to read and modify documents, update formulas, generate charts, and visually inspect results.
Performance and file compatibility
- Sheets: Incremental scrolling redraws newly visible areas. Bulk paste, incremental calculation, and shared formula lookup reduce repeated work.
- Docs: Progressive layout prioritizes content near the editing position and reuses existing layout after local edits. An optional layout Worker moves processing off the main thread.
- Boards and Slides: Improved rendering during dragging, shape cache reuse, and visibility-based presentation thumbnail updates reduce unnecessary canvas work.
- Across editors: Refined Ribbon layout, dark themes, RTL support, and broader coverage for comments, permissions, version history, and snapshot comparison APIs.
Exchange in the Server SDK imports XLS/XLSX, DOC/DOCX, and PPT/PPTX, and exports XLSX, DOCX, and PPTX. Spreadsheets also support CSV and TSV import and export. This release improves preservation of formulas, charts, document pagination, and presentation content. Conversion can run directly in Node.js for batch jobs; see the file conversion guide.
Breaking changes and migration
Browser requirements and package formats
The Web SDK compilation target moves from Chrome 70 to Chrome 88. The supported baseline is Chrome/Edge 88, Firefox 90, Safari 14.1, and Electron 12.
Presets no longer ship UMD builds. Applications loading presets through script tags must move to a module-based build.
Removed Facade APIs
Replace legacy calls with the current APIs:
| Removed API | Replacement |
|---|---|
createUniverSheet()
| createWorkbook()
|
getActiveUniverSheet()
| getActiveWorkbook()
|
getUniverSheet()
| getWorkbook()
|
| Legacy event hooks | addEvent()
|
Exchange and custom integrations
- Product-specific Exchange APIs: Replace
importXLSXToSnapshotAsync()withimportSheetToSnapshotAsync()and load@univerjs-pro/sheets-exchange-client/facade. Review plugin registration and service configuration in the Sheets import/export guide. - Advanced APIs and package changes: Review Docs, chart, and shape Facade integrations. Version history now uses shared modules plus product plugins; some formula services and types have moved to
@univerjs/engine-formula. Check imports, parameters, and return values against the API reference. - Removed custom code execution paths: Uniscript has been removed. Custom formula registration no longer transfers function source over RPC for remote deserialization. Bundle trusted functions with your Worker and register them in the environment where they execute.
Keep interdependent Univer packages on matching versions. After migrating, validate representative documents through editing, saving, undo, import/export, and collaboration.
0.25 maintenance: The 0.25 series will receive security updates only for one year from the release of Univer 1.0. New features and other improvements are available in 1.0.
Get started
For a new Sheets integration:
npm install @univerjs/presets@1.0.0 @univerjs/preset-sheets-core@1.0.0Continue with the Sheets installation guide, or use the Docs installation guide. Each editor's documentation covers the packages and services needed for its features.
Thank you to everyone who contributed code, reported issues, improved the documentation, and tested the prereleases.
Full changes: v0.25.2…v1.0.0