Change8

Migrating to Chainlit 2.9.4

Version 2.9.4 introduces 1 breaking change. This guide details how to update your code.

Released: 12/25/2025

1
Breaking Changes
1
Migration Steps
0
Affected Symbols

Breaking Changes

Issue #1

If you use persistence, you must run the SQL command: `ALTER TABLE steps ADD COLUMN IF NOT EXISTS modes JSONB;` to migrate the database schema.

Migration Steps

  1. 1
    If persistence is enabled, execute the following SQL command against your database: `ALTER TABLE steps ADD COLUMN IF NOT EXISTS modes JSONB;`

Release Summary

This release introduces new features like thread sharing icons and auto-scroll disabling, alongside a critical database migration step for users utilizing persistence and a security fix.

Need More Details?

View the full release notes and all changes for Chainlit 2.9.4.

View Full Changelog