AdapTable for AG Grid
What is AdapTable for AG Grid?
AdapTable is a drop-in extension for AG Grid that turns it into a complete data application — without you having to build one.
Add AdapTable alongside your existing AG Grid instance and you immediately get layouts, querying, filtering, charting, styled columns, conditional formatting, exports, alerts, and dozens of other advanced features
Note
- AG Grid is the best all-round JavaScript DataGrid on the market
- AdapTable builds on top of it without hiding or replacing any of its functionality
All the features that you would otherwise need to build bespoke for all your grids are available out of the box.
Everything your users do — sort, filter, format, customise — is persisted, shareable across teams, and fully configurable in code.
Caution
AdapTable only works with the AG Grid Enterprise Version as it extends many of that Grid's advanced features
- This demo illustrates how AdapTable integrates with the excellent AG Grid providing additional, cutting-edge features for advanced users.
- The dummy data it contains is used in most of the demos in this documentation and comes from Github.
- The demo includes the 3 elements that are typically included in every AdapTable-based application (click on 'Show Code' to see more):
- Initial Adaptable State: objects created for first time use
- Adaptable Options: configuration settings and JavaScript functions
- Adaptable API: providing run-time access to AdapTable functionality
- Each of these are explained in greater length in the demos and pages on this site.
- Switch to 'Light Theme' in the Tool Panel to see AdapTable (and AG Grid) in the light theme
- Click on the
Show Codebutton above the demo to see all the code used in this example, orForkthe demo to extend it
How does AdapTable work?
AdapTable extends AG Grid by providing a set of complementary features designed to meet advanced DataGrid use cases.
Hint
AdapTable provides full support for all AG Grid functionality including Modules, Pivoting, Master / Detail, Charts etc.
What can I do with AdapTable?
AdapTable ships with over 150 features that turn AG Grid into a fully-featured data application — without you having to write any of them.
Some of the more commonly used features include:
Layout & Theme
- Layouts — save, switch and share named grid views
- Pivots, Groups & Aggregations for slicing and summarising data in-place
- Theming with built-in light and dark themes
- Custom Dashboards, Tool Panels and Settings Panels
Find & Filter
- Quick Search — type to highlight matches across the grid
- Column Filters and Grid Filters
- AdapTable Query Language — an expressive, reactive expression engine
Style & Format
- Styled Columns — Badges, Ratings, Sparklines, PercentBars, Gradients and more
- Format Columns for conditional styling and display formats
- Flashing Cells to draw the eye to live data changes
Extend Your Data
- Calculated Columns — formulae, aggregates and reactive expressions
- FreeText Columns for user-editable annotations
- Notes and Comments attached to cells and rows
Notify & Automate
- Alerts — rule-based, scheduled, or both
- Exports to Excel, CSV, JSON, Clipboard and OpenFin
- Schedules for time-based actions and reports
Collaborate & Control
- Team Sharing — push named configurations to colleagues
- Permissions & Entitlements
- Audit Log for compliance and support
Find Out More
- See the Features List for a comprehensive list of all features in AdapTable
- Visit the Demos page to see all of these features running live
Frameworks & Environment
Which frameworks are supported?
AdapTable comes in 4 flavours:
| Flavour | Framework Picker | Extends | Installation | Integration |
|---|---|---|---|---|
| AdapTable TypeScript | TypeScript | AG Grid JavaScript | Installation | Integration |
| AdapTable React | React | AG Grid React | Installation | Integration |
| AdapTable Angular | Angular | AG Grid Angular | Installation | Integration |
| AdapTable Vue | Vue | AG Grid Vue | Installation | Integration |
Hint
- Use the framework picker in the header to read the matching product overview: TypeScript, React, Angular, or Vue
- Learn how to build Custom Components: Toolbars, Tool Panels, Settings Panels, Menu Items & Windows etc
Can I run multiple AdapTables on the same page?
Yes — AdapTable is designed to support multiple instances on a single page, a common pattern in dashboards, trading blotters and multi-grid analytics applications.
Each instance is identified by its AdaptableId, which keeps the state, configuration and Team Sharing data of each grid fully separate.
Hint
Each AdapTable instance is fully independent — they can use different themes, layouts and even different row models on the same page
Where does AdapTable run?
AdapTable is guaranteed to work in Chromium browsers (e.g. Chrome, Edge, Opera etc.)
Note
We aim, but do not guarantee, to keep AdapTable compatible with other leading browsers like Firefox and Safari
Caution
AdapTable does not support Internet Explorer
AdapTable also works inside Electron and other Chromium-based frameworks.
AdapTable is fully compatible with OpenFin and interop.io (and includes extra, bespoke functionality when running in either of those containers).
Find Out More
See OpenFin Plugin and interop.io Plugin for details of integration with these 2 partners
AG Grid & Data
Which row models are supported?
AG Grid provides 4 different 'Row Models' for different use cases, 3 of which are supported by AdapTable:
Note
A Row Model is essentially a mechanism for loading data into AG Grid
| Name | Description | Server Based | AdapTable Support |
|---|---|---|---|
| Client Side | All data loaded into grid, all actions on client | ❌ | ✅ |
| Server side | Supports lazy loading, including groups & aggs | ✅ | ✅ |
| Viewport | Loads data only for rows currently visible | ✅ | ✅ |
| Infinite | Loads Data as User Scrolls | ✅ | ❌ |
The Client-Side Row Model is the default - both for AdapTable and AG Grid - and is the most feature rich, allowing users to access advanced Querying and Filtering functionality straight out of the box.
All the demos in this documentation use the Client Side Row Model.
Hint
- Use the Client Side Row Model wherever possible: it requires the least additional work and is the most dependable
- Only use a different Row Model if you have proven that loading all the data up front is insufficient for your needs
AdapTable also works fully with the Server-Side Row Model and provides additional support and assistance for external filtering and querying (since these are not available natively).
Caution
- AdapTable extends AG Grid Enterprise so does not officially support the Infinite Row Model
- But it does fully support the Server-Side Row Model - which extends it - as well as the ViewPort Row Model
Does AdapTable handle live and streaming data?
Yes — AdapTable was built with high-throughput, ticking data in mind and is widely used in financial trading applications where rows update many times per second.
When data changes:
- Alerts, Calculated Columns and Filters re-evaluate in real time
- Flashing Cells draw attention to changes
- Reactive Expressions watch values and react as they change
Hint
AdapTable adds no measurable overhead to AG Grid; your grid remains as fast as it would be without AdapTable
How does AdapTable work with AG Grid?
AdapTable extends AG Grid.
This means AdapTable doesn't hide AG Grid in any way.
Everything available in AG Grid works fully in AdapTable, and developers still have full access to the full AG Grid Api and can code against it just as if AdapTable was not being used.
Note
- AdapTable will typically add extra features to AG Grid functionality (e.g. for Master Detail or Row Grouping)
- But sometimes (as in Tree Data) AdapTable merely supports what AG Grid provides
AdapTable always supports the most recent major version of AG Grid.
Find Out More
See the Release Schedule for a table showing which AG Grid version is supported in each AdapTable version
Which version of AG Grid is required?
The current major version — AdapTable 23 — extends AG Grid v.35.3.0.
Find Out More
See the Release Schedule for the full version-compatibility table
Configuration & State
Does AdapTable have server components?
No, AdapTable runs purely in your client and has no server. However it contains many features that help you perform searching & filtering on the server rather than client.
How is user configuration saved?
Every customisation a user makes — Layouts, Filters, Styled Columns, Themes, Dashboard arrangement and dozens of other settings — is collected into a single Adaptable State object.
By default this state is persisted to local storage, so you find the grid exactly as you left it next time you open it.
For production deployments, AdapTable provides full hooks for Custom State Persistence so you can save state remotely e.g. to your own database, REST endpoint or cloud store (a working Supabase example is included).
Hint
Provide Initial Adaptable State to ship Layouts, Filters and Styles with your app before any user customisation is applied
Can users share their configuration with the team?
Yes — Team Sharing lets users publish their configurations (Layouts, Filters, Styled Columns, Alerts, etc.) for colleagues to import directly into their own grid.
Team Sharing runs in one of two modes:
- Active — users push and pull configurations on demand
- Referenced — shared objects are linked and update automatically when the source changes
Hint
Combine Team Sharing with Permissions to allow only senior users to publish configurations to the rest of the team
Can we personalise AdapTable?
Yes, AdapTable is designed to be fully configurable and extensible.
Some of the many "personalisation" options include:
- Theming AdapTable to match your colour scheme
- Providing custom Dashboard Toolbars, Tool Panels and Settings Panels
- Adding an Application Icon
Development
Can AdapTable be tested?
Yes, AdapTable is full testable and works with all testing libraries, e.g. Jest, Playwright, Vitest etc
Find Out More
See the Developer Guide to Testing AdapTable for full instructions
What is AdapTable written in?
AdapTable is written in TypeScript (version 5.5.4) and uses React internally.
Hint
You do not need to use TypeScript to access AdapTable, but if you do, make sure to use version 5.5.4 or higher
Caution
The minimum required version of React is 18; avoid using imports / libraries which require a lower version of React
Which English variant is used?
AdapTable is written in British English.
Hint
- This can be changed to American English if required
- Full internationalisation is high on our Road Map and coming very soon
How can I see logging messages from AdapTable?
AdapTable ensures that all critical messages are always visible in the console. Other messages are only visible if you turn logging on.
Find Out More
See Logging for full instructions on configuring AdapTable's log levels
Licensing & Releases
How is AdapTable licensed?
AdapTable is licensed on an application basis — a single licence covers any number of developers, end users and deployments for a given application.
Two licence types are available:
- Single Application — for use in one named application
- Multiple Application — for use in unlimited applications
Find Out More
See AdapTable Licenses for licence options, pricing and how to request a quote
Caution
AdapTable extends AG Grid Enterprise — you will also need a separate AG Grid Enterprise licence
Is AdapTable open source?
No — AdapTable is a commercial product.
You can evaluate AdapTable before purchasing, and the team is happy to provide trial licences for evaluation projects.
Hint
All code used in this documentation's demos is freely available to copy, fork and use in your own applications
How is AdapTable supported?
The best way to access AdapTable Support is by raising a Zendesk Support Ticket.
Find Out More
See the Support Guide for full instructions on how to raise tickets and provide examples
When is AdapTable updated?
AdapTable release regular new versions containing enhancements, new features and bug fixes.
There are a minimum of 6 Releases a year (2 of which are guaranteed to be major), but in reality there are many more.
Other Products
Are there other AdapTable products?
AdapTable for Infinite Table will be officially released in January 2027.
This contains a very similar feature-set to AdapTable for AG Grid and extends Infinite Table for React.
Where do I go next?
| Topic | Description |
|---|---|
| Installation & Integration | Install AdapTable and wire it up to your AG Grid instance |
| Key Concepts | Understand the core building blocks used throughout AdapTable |
| Demos | See AdapTable's features running live — and fork the code |
| UI Guides & Tutorials | Build custom Toolbars, Tool Panels, Settings Panels, Menu Items and Windows |
| Developer Tutorials | Step-by-step guides for the most common integration tasks |
| AdapTable Query Language | Master AdapTableQL — the engine behind Filters, Alerts and Calculated Columns |
| Adaptable Options | Full reference for every configurable option |
| Adaptable API | Drive AdapTable programmatically from your application code |
| Latest Release Notes | What's new in the current major version |