For AI agents: a documentation index is available at llms.txt. Use .md for canonical markdown pages; .mdx is kept as a backwards-compatible alias on supported URL paths.
assistant-ui logoassistant-ui/Docs/Migrations
  • Playground
  • Gallery
Cloud
  • Playground
  • Gallery
  • Pricing
Cloud
PlaygroundGallery
LearnExamplesShowcaseChangelog
CompanyBlogTractionCareersBrand
Open sourceGitHubPackagesReact NativeInk
Pricing
Cloud

Migration Guides

Upgrade assistant-ui versions and migrate deprecated APIs and integrations.

Use these guides when upgrading assistant-ui or moving from APIs that have been deprecated or replaced.

Version upgrades

Migration to v0.14

Replace APIs removed after v0.11 and v0.12, and migrate primitive components props to children render functions.

Migration to v0.12

Move from individual context hooks to the unified state API.

Migration to v0.11

Update code affected by the ContentPart to MessagePart rename.

APIs and integrations

Migrating Tools to Toolkits

Move legacy tool and tool UI registrations to the toolkit API.

Migrating to react-langgraph v0.7

Upgrade to the simplified LangGraph integration API.

Using old React versions

Review compatibility notes for React 18 and React 19.

Stability

Deprecation Policy

Review stability guarantees and deprecation timelines for assistant-ui features.

Utilities / react-o11yDeprecation Policy

On this page

  • Version upgrades
  • APIs and integrations
  • Stability
View as MarkdownEdit on GitHub

We are hiring

Build the future of agentic UI with us →

Migration GuidesDeprecation PolicyMigrating Tools to ToolkitsMigration to v0.11Migration to v0.12Migration to v0.14Migrating to react-langgraph v0.7Using old React versions
Ask AI