---
title: 'v3.10.0'
created_at: 11/3/2025
updated_at: 11/3/2025
keywords:
  - changelog
  - release
  - v3.10
  - v3.10.0
  - v3.10.1
  - v3.10.2
  - v3.10.3
  - rich-text
  - tiptap
  - performance
  - collaboration
status: published
---

This release introduces rich text as a first-class primitive within the Editor, alongside various performance improvements and bug fixes.

## What's new

### Rich text support

The SDK now offers rich text as a first-class primitive. The implementation utilizes TipTap with its StarterKit extension plus additional customizations. Developers can configure this functionality through a `textOptions` property to customize TipTap and modify extensions.

## API changes

- 💥 **`text` property** on most shapes replaced with `richText`. When setting values, use `richText: toRichText('some string')` instead of `text: 'some string'`. When retrieving values, use `renderPlaintextFromRichText(props.text)` rather than `props.text`.
- Add asset rehydration for .tldr files containing embedded base64 data.
- Add `BrokenAssetIcon` display on file upload failures.
- Add public collaboration hooks (`usePeerIds`, `usePresence`).
- Add `userId` parameter to collaboration components.

## Bug fixes

- Fix performance regression affecting document loading.
- Fix Firefox export/style embedding for foreignObjects.
- Fix shape reparenting order preservation.
- Fix resize functionality.
- Fix Safari file pasting issues.
- Fix SSR environment compatibility (core-js import removal).
- Fix IME text duplication in Chrome.

[View release on GitHub](https://github.com/tldraw/tldraw/releases/tag/v3.10.0)

---

## Patch releases

### v3.10.1

- Fix API reference links in state packages. ([#5610](https://github.com/tldraw/tldraw/pull/5610))

[View release on GitHub](https://github.com/tldraw/tldraw/releases/tag/v3.10.1)

### v3.10.2

- Add `textOptions` to `<TldrawImage />` component. ([#5650](https://github.com/tldraw/tldraw/pull/5650))

[View release on GitHub](https://github.com/tldraw/tldraw/releases/tag/v3.10.2)

### v3.10.3

- Fix Inter font being embedded in exports. ([#5676](https://github.com/tldraw/tldraw/pull/5676))
- Reduce excessive styling in exported content. ([#5676](https://github.com/tldraw/tldraw/pull/5676))

[View release on GitHub](https://github.com/tldraw/tldraw/releases/tag/v3.10.3)