●Change8

Migrating to Panel v1.9.0

Version v1.9.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 5/21/2026

2
Breaking Changes
4
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

pn.serveWidget.labelWidget.nameButton.button_typeButton.colorButton.button_styleButton.variantChatFeedTextEditorJSONEditorTabulatorGaugeEChartsReactComponent

Breaking Changes

●Issue #1

Support for Bokeh 3.7 has been dropped. Users must upgrade to a newer version of Bokeh.

●Issue #2

The parameter `button_type` on buttons has been renamed to `color`. Update code referencing `button_type` to use `color` instead.

Migration Steps

  1. 1
    If you were using `widget.name`, change it to `widget.label`.
  2. 2
    If you were using `button.button_type`, rename it to `button.color`.
  3. 3
    If you were using `button.button_style`, rename it to `button.variant`.
  4. 4
    Ensure your Bokeh dependency is greater than 3.7.

Release Summary

Panel 1.9.0 introduces full typing compatibility with Param 2.4.0 and adds support for wildcard routing in `pn.serve`. This release also modernizes the widget API by canonicalizing the label parameter and renaming button style attributes.

Need More Details?

View the full release notes and all changes for Panel v1.9.0.

View Full Changelog