Skip to main content

🚚 Plugin Migration Guides

Open WebUI occasionally ships releases that require updates to existing Tools, Functions, Pipes, Filters, and Actions. This section collects the per-version migration guides for plugin authors.

Pick the guide that matches the version you are upgrading from. If you are crossing multiple major versions, work through the guides in order.

Available Guides​

  • Migrating to 0.5.0 — the apps → routers restructure, unified chat_completion endpoint, and the new __request__ parameter in function signatures.
  • Migrating to 0.9.0 — the backend-wide sync → async refactor. Database model methods and most open_webui.* helpers now return coroutines and must be awaited.

💬 Questions or Feedback? If you run into issues upgrading a plugin, open a GitHub issue or ask in the community forums.

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.