Version 23 Developer Release Note

AdapTable 23.0 is a major version release.

It contains a refactored and enhanced AdapTable UI and 4 new user-requested Styled Columns.

Upgrading with AI

• The adaptable-upgrade Agent Skill can plan the move from AdapTable 22 to 23 for you: it checks the changes in this Release Note (including the removed Scheduling API, the CSS changes and the deprecations) against your repository and writes a reviewable plan, which your coding agent then applies
• Install the AdapTable Skills in your project with:

• Then ask your agent: "Use the adaptable-upgrade skill to plan the upgrade of this project to AdapTable 23", review the plan it writes, and ask it to apply the plan in a new session

Styled Columns

• AdapTable 23.0 contains a very big refactoring of, and expansion to, Styled Columns

• AdapTable now provides 4 new Styled Columns (in response to user requests):

  • Bullet Chart Style - renders a bullet graph inside a cell
  • Rating Style - displays a row of icons (e.g. stars) scaled to the cell value
  • Icon Style - maps cell values to icons with presets and optional cell text
  • Range Bar Style - shows value and optional reference on track between min & max

• Additionally we made improvements to the 4 existing Styled Columns including:

  • Gradient Style - includes a new zero-centred range (for columns with negative numbers)
  • Percent Bar Style - provides better support for negative ranges
  • Badge Style - has a large number of new styling and formatting options
  • Sparkline Column - improved UI makes it easier to create sparklines at runtime

Scheduling

• Scheduling has been refactored in AdapTable 23.0 in significant ways:
  • Reminders have been replaced with Scheduled Alerts - a new type of Alert
  • Scheduled Reports are now part of the Report object (and persisted in Export state)
  • The Schedule object now fully supports Cron expressions
  • AdapTable users can more easily create either one-off or recurring schedules

General Enhancements

• Calculated Column now Flash and trigger Alerts when their values (dynamically) change
• Column Menu and Context Menu now both support Framework (i.e. React, Angular or Vue) components
• Custom Toolbars can now include an Adaptable Form
• Options to show Notes and Comments via Menu (and not only by hover)
• Grid Info Panel now also lists all Adaptable Options
• Numeric Presets have been significantly expanded (e.g. Euro, Bitcoin, Scientific, Accounting, FX Rate etc) and can be provided - and persisted - as part of the Format Column definition
• Developers (and end users) can provide custom increment / decrement keys for Plus Minus
• Weighted Average aggregations can be set directly from Column Menu
• All 3 custom Quick Search Styles can be set via the Settings Panel
• Improved way of setting custom navigation in Settings Panel (including headers)

UI Changes

• The index.css file now contains both base styles (the light and dark Themes)

  Important

  This means you now only need to import one CSS file, instead of two

• Improvements to usability and flexibility of the UI Wizards and new Select and Dropdown components

• Further integration with Tailwind

  Note

  • All AdapTable CSS classes have the twa: prefix, so they won't collide with your app if you use Tailwind
  • If using Tailwind we recommend this CSS layer order: @layer theme, base, components, adaptable, utilities
  • The Adaptable styles are all scoped inside the adaptable CSS layer

• Comprehensive accessibility (ARIA) and keyboard support in AdapTable UI — menus, dialogs, dropdowns and wizards follow WAI-ARIA Authoring Practices by default

  Find Out More

  • See Accessibility & Keyboard Support for further details about the changes made
  • For background on the UI refresh, see the blog post on Tailwind, shadcn and Base UI in AdapTable

• The Colour Palette has been extended and made easier to use and customise

Technical Reference

• As a result of the changes to Scheduling (see above) these objects and classes were all removed:

  • The Schedule Module
  • The Schedule section of Adaptable State
  • The ScheduleAPI section of Adaptable API
  • The ScheduleTriggered Adaptable Event

• The previously deprecated getPersistedState function in State API method was removed (and now only its replacement, getPersistentState, remains):

  Note

  This is in line with our policy of removing deprecated methods on the 3rd major release post deprecation

• The navigation property in Settings Panel Options returns a new SettingsPanelNavigationConfigurer object (that allows more flexible configuration options)

  Important

  The previous navigation object is still supported but marked as deprecated and will be removed in a future version

Documentation

• Docs updates as part of ongoing efforts to help devs and users find what they need in AdapTable:
  • Now Framework focussed - you pick a Framework and only see docs and demos for that Framework
  • 8 New Showcase Demos showing AdapTable tackling real world use cases
  • A Feature list detailing all AdapTable features and associated dev properties and UI components
  • A What's New page listing new releases, features and blog posts

Upgrade Guide

AdapTable 23 is a major version, but the breaking surface is concentrated: Scheduling was rebuilt (the Schedule State slice, scheduleApi and the Schedule object all go), the UI refresh removed the separate theme files and a set of CSS variables, and Styled Columns gained a mandatory Name with several style keys regrouped.

The upgrade has two elements:

• Adaptable State — persisted State and initialState as it loads:

  • Styled Columns are rewritten automatically on load (see the Auto-migrated column in the Adaptable State table)
  • The Schedule slice is dropped on load, not converted — Reminders and Report Schedules must be re-created by hand (see State Migration)

• Application source — packages, CSS, Adaptable Options, API calls, object types and initialState literals need to be updated by you; there are 2 paths:

  • Upgrade with AI (recommended): the adaptable-upgrade Skill plans your code changes & your agent applies them
  • Upgrade Manually — run it yourself using the tables of changes below

Upgrade with AI

Upgrading using the adaptable-upgrade Agent Skill is our recommended option (see Upgrading with AI above for installation).

The Skill reads every 22 → 23 change record — the tagged rows of the tables below — through the adaptable CLI, which searches your repository for each one, so the plan names the files and lines that change.

It writes a plan for your repository (ADAPTABLE_UPGRADE_SCOPE.md, ADAPTABLE_UPGRADE_CHANGES.md, ADAPTABLE_UPGRADE_STATE/) and your coding agent then applies it in a fresh session: package bumps, the CSS import and variable changes, the Options and API edits, and the re-creation of Schedules in their new homes.

Upgrade Manually

For those unwilling, or unable, to use AI agents there is an option to manually upgrade.

// a Report Schedule (was Schedule.ReportSchedules)
Export: {
  ReportSchedules: [
    { Name: 'Daily trades', ReportName: 'Trades', ReportFormat: 'Excel', ExportDestination: 'Download', Schedule: { IsOneOff: false, CronExpression: '0 9 * * 1-5' } },
  ],
},
// a Scheduled Alert (was a Reminder in Schedule.Reminders)
Alert: {
  AlertDefinitions: [
    {
      Name: 'Morning check',
      MessageType: 'Info',
      MessageHeader: 'Reminder',
      Schedule: { IsOneOff: true, RunAt: '2026-11-03T09:30:00' },
      AlertProperties: { DisplayNotification: true, DisplaySystemStatusMessage: true },
    },
  ],
},

settingsPanelOptions: {
  navigation: (context, defaultNavigation) => [{ label: '', items: ['Alert', 'MyPanel'] }],
}

State Migration

There is no automatic conversion for the Schedule slice: when v.23 loads State that still contains it, the slice is dropped (AdapTable logs what was there) and nothing is converted.

Re-create each item in its new home — Report Schedules under Export.ReportSchedules, Reminders as Scheduled Alerts in Alert.AlertDefinitions — using the shapes in the Adaptable State table, in initialState and in any persisted State you ship.

Styled Columns are the opposite: their v.22 shapes are rewritten on every load (the Auto-migrated column above), so a v.22 application runs unchanged; bring the source literals up to date when convenient so the migration log stays clean.

Change Log