# Initial State Reference

Canonical page: https://www.adaptabletools.com/docs/technical-reference-initial-state

- AdapTable instances can be pre-populated at Design Time with Initial Adaptable State
- These are the objects that Users require for first time use
- When Adaptable loads, the Initial State is saved into [Adaptable State](https://www.adaptabletools.com/docs/dev-guide-adaptable-state/index.md)

Developers are able to populate each new AdapTable instance with [Initial Adaptable State](https://www.adaptabletools.com/docs/dev-guide-adaptable-state-initial-state/index.md).

This means that when end-users open the new application for the first time, they won't simply see a clean AG Grid instance but, rather, one pre-loaded with Filters, Styles, Edit Rules, Reports etc.

- See [Providing Initial AdapTable State](https://www.adaptabletools.com/docs/dev-guide-adaptable-state-initial-state/index.md) for more details
- Consult the [Adaptable State Guide](https://www.adaptabletools.com/docs/dev-guide-adaptable-state/index.md) for details on how to load and persist AdapTable State

These are the available sections in Initial State, all of which are optional:

- The one exception is the `Layout` section which is required and must contain at least one Layout
- However this too is optional if [Default Layout Creation](https://www.adaptabletools.com/docs/handbook-layouts-default/index.md) is configured

| Property                                                                    | Description                                                         | Details                                                                               |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [Alert](https://www.adaptabletools.com/docs/handbook-alerting/index.md)                       | Defines Alerts when important things happen                         | [Details](https://www.adaptabletools.com/docs/technical-reference-alerting/index.md)           |
| [Application](https://www.adaptabletools.com/docs/dev-guide-adaptable-state-custom/index.md)  | Empty state section for Devs to store own data with rest of state   | [Details](https://www.adaptabletools.com/docs/technical-reference-adaptable-state/index.md)                |
| [Calculated Column](https://www.adaptabletools.com/docs/handbook-calculated-column/index.md)  | Columns that display value (based on an Expression)                 | [Details](https://www.adaptabletools.com/docs/technical-reference-calculated-column/index.md)  |
| [Charting](https://www.adaptabletools.com/docs/handbook-charts/index.md)                      | Named Charts (wrapping Chart models)                                | [Details](https://www.adaptabletools.com/docs/technical-reference-charts/index.md)             |
| [Custom Sort](https://www.adaptabletools.com/docs/handbook-custom-sorting/index.md)           | Sort columns in non-standard (e.g. non alphabetical) ways           | [Details](https://www.adaptabletools.com/docs/technical-reference-custom-sorting/index.md)     |
| [Dashboard](https://www.adaptabletools.com/docs/ui-dashboard/index.md)                        | Gives devs control over look & feel of Dashboard (above grid)       | [Details](https://www.adaptabletools.com/docs/technical-reference-dashboard/index.md)                |
| [Export](https://www.adaptabletools.com/docs/handbook-exporting/index.md)                     | Collection of Custom Reports to export as needed                    | [Details](https://www.adaptabletools.com/docs/technical-reference-exporting/index.md)          |
| [Flashing Cell](https://www.adaptabletools.com/docs/handbook-flashing-cell/index.md)          | Definitions of which cells flash in response to data changes        | [Details](https://www.adaptabletools.com/docs/technical-reference-flashing-cell/index.md)      |
| [Format Column](https://www.adaptabletools.com/docs/handbook-column-formatting/index.md)      | Objects that style a column either fully or using a Condition       | [Details](https://www.adaptabletools.com/docs/technical-reference-styling-formatting/index.md) |
| [Freetext Column](https://www.adaptabletools.com/docs/handbook-freetext-column/index.md)      | Bespoke columns that get stored in state for users' notes           | [Details](https://www.adaptabletools.com/docs/technical-reference-freetext-column/index.md)    |
| [Layout](https://www.adaptabletools.com/docs/handbook-layouts/index.md)                       | Named sets of column props (visibility, order, grouping, sorts etc) | [Details](https://www.adaptabletools.com/docs/technical-reference-layouts/index.md)            |
| [Named Query](https://www.adaptabletools.com/docs/handbook-named-queries/index.md)            | Queries available for use across multiple AdapTable Modules         | [Details](https://www.adaptabletools.com/docs/technical-reference-named-query/index.md)        |
| [Notes](https://www.adaptabletools.com/docs/handbook-notes/index.md)                          | Collection of personal Notes that are edited at Cell level          | [Details](https://www.adaptabletools.com/docs/technical-reference-notes/index.md)              |
| [Plus Minus](https://www.adaptabletools.com/docs/handbook-editing-plus-minus/index.md)        | Rules regarding result of user clicking '+' or '-' in numeric cell  | [Details](https://www.adaptabletools.com/docs/technical-reference-editing/index.md) |
| [Quick Search](https://www.adaptabletools.com/docs/handbook-quick-search/index.md)            | Configures matching cell styles, and whether to filter also         | [Details](https://www.adaptabletools.com/docs/technical-reference-quick-search/index.md)       |
| [Shortcut](https://www.adaptabletools.com/docs/handbook-editing-shortcut/index.md)            | Collection of objects to encourage fast and safe data entry         | [Details](https://www.adaptabletools.com/docs/technical-reference-editing/index.md)   |
| [Status Bar](https://www.adaptabletools.com/docs/ui-status-bar/index.md)                      | Configures Adaptable components in AG Grid Status Bar               | [Details](https://www.adaptabletools.com/docs/technical-reference-status-bar/index.md)               |
| [Styled Column](https://www.adaptabletools.com/docs/handbook-styled-column-overview/index.md) | Collection of Badges, Gradient Columns, Percent Bars & Sparklines   | [Details](https://www.adaptabletools.com/docs/technical-reference-styled-column/index.md)      |
| [Theme](https://www.adaptabletools.com/docs/handbook-theming/index.md)                        | Specifies current Theme                                             | [Details](https://www.adaptabletools.com/docs/technical-reference-theming/index.md)            |
| [Tool Panel](https://www.adaptabletools.com/docs/ui-tool-panel/index.md)                      | Order & visibility of AdapTable Tool Panel controls (side of grid)  | [Details](https://www.adaptabletools.com/docs/technical-reference-tool-panel/index.md)               |
| [User Interface](https://www.adaptabletools.com/docs/technical-reference-ui/index.md)         | Sets visibility of Dashboard, Tool Panel, Status Bar, Menus and related UI | [Details](https://www.adaptabletools.com/docs/technical-reference-ui/index.md)                   |

Comments, Team Sharing and Data Sets are configured in [Adaptable Options](https://www.adaptabletools.com/docs/technical-reference-adaptable-options/index.md) — they are not Initial State.

See the Types Section for the full definition of the [`initialState`](https://www.adaptabletools.com/docs/reference/initialstate.md) object
