Starstruk Logo MarkStarstruk

v0.20.0

dream-num/univerv0.20.0Apr 3, 2026by wpxp123456

AI Summary

Univer v0.20.0 introduces Headless mode support by migrating Drawing APIs to the core package, adds image editing features like cropping to shapes and image fills, and enhances Univer Server with idempotent keys and metadata support.

Key Highlights

  • Headless mode support via migration of Drawing APIs (floating images, charts, shapes) from UI to core package
  • New image editing capabilities: cropping floating images into shapes and adding image fills to shapes
  • Univer Server improvements: idempotent keys and customer Metadata support
  • Optimized Excel file import performance

Breaking Changes

  • Drawing-related APIs (floating images, charts, shapes) have been migrated from the UI package to the core package to support Headless mode. Plugin installation mode users must update import paths: `@univerjs/sheets-drawing-ui` -> `@univerjs/sheets-drawing`, `@univerjs-pro/sheets-chart-ui` -> `@univerjs/sheets-chart`, and `@univerjs-pro/sheets-shape-ui` -> `@univerjs/sheets-shape`.

New Features

  • Support for cropping floating images into shapes
  • Support for image fill in shapes
  • Support for importing and exporting cropped images and shapes with image fill
  • Support for idempotent keys in system integration
  • Support for passing customer system Metadata

Full Release Notes

## 🎊 Univer@v0.20.0

### 🚧 Important Note

Your feedback is crucial! Please submit [issues](https://github.com/dream-num/univer/issues) and suggestions to help us shape the future of Univer.

### 🚀 Getting Started

If you're eager to explore Univer, check out our [getting started documentation](https://docs.univer.ai/guides/sheets/getting-started/installation).
Dive into the world of collaborative document, spreadsheet, and presentation editing powered by Univer!

### 📊 Univer Sheets

#### 💔 Breaking Changes

- The Drawing-related APIs (floating images, charts, shapes) have been migrated from the UI package to the core package to support usage in **Headless mode**.
  For users using the Plugin installation mode, please update the import paths for the Facade APIs:
  - New for floating images: `import '@univerjs/sheets-drawing/facade'`
  - UI-related capabilities such as floating DOM still use: `import '@univerjs/sheets-drawing-ui/facade'`
  - Charts: `import '@univerjs-pro/sheets-chart-ui/facade'` -> `import '@univerjs/sheets-chart/facade'`
  - Shapes: `import '@univerjs-pro/sheets-shape-ui/facade'` -> `import '@univerjs/sheets-shape/facade'`

#### ✨ New Features Highlights

- Add support for cropping floating images into shapes (entry: image editing panel).
- Add support for image fill in shapes (entry: shape editing panel).

### 🌐 Univer Server

- Add support for importing and exporting floating images cropped into shapes.
- Add support for importing and exporting shapes with image fill.
- Optimize Excel file import performance.
- Add new system integration capabilities:
  - Support for **idempotent keys**.
  - Support for passing customer system **Metadata**.

For usage, see: https://docs.univer.ai/guides/pro/usip and https://docs.univer.ai/guides/pro/api.

### 📦 Univer Presets

- SDK has been updated to version 0.20.0.

### 📢 Join the Conversation

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

- :octocat: [GitHub Discussions](https://github.com/dream-num/univer/discussions)
- 👾 [Discord](https://discord.gg/z3NKNT6D2f)

### 📝 Changelog

[Full changelog](https://github.com/dream-num/univer/compare/v0.19.0...v0.20.0) (2026-04-03)

### Features

* **image:** feat img clip by shape in OSS ([#6765](https://github.com/dream-num/univer/issues/6765)) ([96ec7de](https://github.com/dream-num/univer/commit/96ec7dec6c1a86c0846ce94c02e4ab7203c24c0a))