⚠️ Breaking Change
Impact Score: 7/10
Twenty v2.8.0 — Release Notes & Engineering Impact
Source available — automated, not human-reviewed
Component: twenty · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
Breaking-change evidence from the source
⚠️ Breaking changes - **Permission flags** — new system to define permission flags by apps - **Channel standard objects deprecated** — `messageChannel`, `messageFolder`, `calendarChannel` moved out of workspace schemas into core metadata (#20836) — this is just a cleanup, had been deprecated for some time already
- API breaking-change CI guard (#20848) - `twenty_upgrade_instance_info` metric for upgrade observability (#20854) - Auto-indexing of polymorphic `target<X>Id` join columns (#20820)
⚡ Executive Summary (TL;DR)
Twenty v2.8.0. Source highlight: **Custom indexes UI** — manage data model indexes from the Settings UI (#20846)
Who Does This Impact? (Role-Based Analysis)
💻 Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
📊 Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
⚙️ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
⚠️ Breaking Changes & Deprecations (2)
- ⚠️ Breaking changes - **Permission flags** — new system to define permission flags by apps - **Channel standard objects deprecated** — `messageChannel`, `messageFolder`, `calendarChannel` moved out of workspace schemas into core metadata (#20836) — this is just a cleanup, had been deprecated for some time already
- - API breaking-change CI guard (#20848) - `twenty_upgrade_instance_info` metric for upgrade observability (#20854) - Auto-indexing of polymorphic `target<X>Id` join columns (#20820)
✨ New Features & Capabilities (4)
- **Custom indexes UI** — manage data model indexes from the Settings UI (#20846)
- **Text field widget editor mode** (#20779)
- **AI Chat** — new navigation menu item, webhook tool providers (#20759), plus end-to-end observability (#20850)
- **Partners app + directory** — new `twenty-partners` app and website directory (#20792, #20632)
⚡ Performance & Enhancements (5)
- Rotate connected-account `connectionParameters` via `secret-encryption:rotate` (#20807)
- API breaking-change CI guard (#20848)
- `twenty_upgrade_instance_info` metric for upgrade observability (#20854)
- Auto-indexing of polymorphic `target<X>Id` join columns (#20820)
- Install applications via tarball download instead of `yarn install` (#20835)
📄 View Raw Release Notes (Original Developer Log)
## Highlights
### Features
- **Custom indexes UI** — manage data model indexes from the Settings UI (#20846)
- **Text field widget editor mode** (#20779)
- **AI Chat** — new navigation menu item, webhook tool providers (#20759), plus end-to-end observability (#20850)
- **Partners app + directory** — new `twenty-partners` app and website directory (#20792, #20632)
### ⚠️ Breaking changes
- **Permission flags** — new system to define permission flags by apps
- **Channel standard objects deprecated** — `messageChannel`, `messageFolder`, `calendarChannel` moved out of workspace schemas into core metadata (#20836) — this is just a cleanup, had been deprecated for some time already
### Upgrade notes
This release ships 3 per-workspace migrations that run on the first `yarn command:prod upgrade` after deploy:
1. Drop deprecated channel standard objects from workspace schemas
2. Backfill relation join column indexes
3. Gate default command menu items by permission flag
### Notable improvements
- Rotate connected-account `connectionParameters` via `secret-encryption:rotate` (#20807)
- API breaking-change CI guard (#20848)
- `twenty_upgrade_instance_info` metric for upgrade observability (#20854)
- Auto-indexing of polymorphic `target<X>Id` join columns (#20820)
- Install applications via tarball download instead of `yarn install` (#20835)
### Security
- Bumped protobufjs and esbuild to clear CVEs (#20876)
### Bug fixes
~20 fixes including billing cap writes & orphaned Stripe subs, localization date parsing, workflow UUID filter operands & cron-trigger cache TTL, AI Chat browser-context injection, API keys list refresh, onboarding modal layout, IMAP/SMTP message threading.
**Full Changelog**: https://github.com/twentyhq/twenty/compare/v2.7.0...v2.8.0