---
canonical_url: "https://tiptap.dev/docs/ui-components/getting-started/changelog"
---

# Changelog

All notable changes to this project will be documented in this file.

## \[2026-03-26]

### Added

- **TOC**: Added support to find the closest scrollable parent element for the Table of Contents (TOC) node preview.

### Changed

- **TOC**: Improve heading organization in the Table of Contents (TOC) for better performance and readability.

## \[2026-03-25]

### Added

- **Indentation support**: Added `indent` and `outdent` commands to the editor, allowing users to adjust block indentation levels. Currently this feature only available for Notion-like template.

## \[2026-02-19]

### Changed

- **AI menu**: Added `anchorToSelection` prop to `<AiMenu>` for anchoring the menu to the current text selection at full editor width.

## \[2026-02-10]

### Fixed

- **Toolbar buttons**: Fixed button visibility logic where buttons were incorrectly hidden when `hideWhenUnavailable` was not set. Buttons now always show by default and only hide when `hideWhenUnavailable={true}` and the required extension/schema is unavailable.
- **Link popover**: Added error handling around `setMark("link")` to prevent uncaught exceptions in certain editor states.
- **Turn-into dropdown**: Added missing `!editor.isEditable` guard to prevent showing the dropdown on read-only editors.
- **Heading node**: Fixed `margin-top` removal to properly target first headings and headings preceded by ProseMirror widgets (e.g., decorations, node views).
- **Color highlight**: Switched from `toggleMark("highlight", { color })` to the proper `toggleHighlight({ color })` command for correct toggle behavior.

### Changed

- **CLI auth check on `-c` flag**: The CLI now verifies `.npmrc` authentication when using the `-c` (component) flag, preventing silent failures for unauthenticated users.
- **Auto-generate `scss.d.ts`**: SCSS type declarations are now automatically created whenever a component with SCSS files is installed via the CLI.
- **Nested list styles**: Added style cycling for deeply nested lists (up to 8 levels):
  - Ordered lists: `decimal → lower-alpha → lower-roman → decimal → ...`
  - Unordered lists: `disc → circle → square → disc → ...`
- **Color highlight `useColorValue` prop**: Added support for using raw hex color values instead of CSS variables, enabling highlight compatibility in environments where CSS custom properties aren't available.
- **Heading dropdown menu**: Added support for custom `children` prop, allowing consumers to override the default icon + chevron rendering.
- **Inline images**: Images inside paragraphs now display as `inline-block`.

### Removed

- **Comment page demo**: Removed the `/comments` and `/preview/templates/comments` routes and all associated components.

## \[2026-02-03]

- Update CLI version to 3.18.0. Fix `-p` flag for custom paths.

## \[2026-01-15]

### Fixed

- Prevent block “turn into” actions from running when multiple blocks are selected, ensuring node toggles only apply to a single selected block.
  update existing code by running `pnpm dlx @tiptap/cli@latest add heading-button blockquote-button list-button text-button code-block-button -o`

## \[2026-01-09]

### Added

- Table of Contents (TOC) feature with node preview
- Update CLI version to 3.11.1

## \[2026-01-05]

### Added

- Add `resetTextSelectionOnClose` prop to `FloatingElement` to add an option to preserve the current editor selection when the editor loses focus

## \[2025-12-15]

### Fixed

- Remove stopEvent from image to fix copy and paste an inline image

## \[2025-12-04]

### Added

- Merge adjacent lists on backspace to prevent stuck vertical spacing

---

## Legend

- **Added**: New features
- **Changed**: Changes in existing functionality
- **Deprecated**: Soon-to-be removed features
- **Removed**: Removed features
- **Fixed**: Bug fixes
- **Security**: Security fixes and improvements