# Column Menu

Canonical page: https://www.adaptabletools.com/docs/ui-column-menu

- AdapTable extends AG Grid's column header menu — AG Grid still owns the menu chrome; AdapTable adds module items via `columnMenuOptions.customColumnMenu`
- The Menu provided by AG Grid in each Column Header is extended by AdapTable
- As a result 3 sets of Menu Items can appear in the Column Menu:
  - Provided by **AG Grid**
  - Shipped by **AdapTable**
  - Supplied by **Developers**
- Developers have full control over the content and order of these sections

AG Grid provides a Column Menu which appears in each Column Header.

AdapTable supports and extends this Column Menu in various ways.

- The AG Grid Column Menu is typically accessed by clicking the 3 horizontal dots in each Column Header
- The Menu only displays if the [MenuModule](https://www.adaptabletools.com/docs/getting-started-aggrid-modules/index.md#selecting-modules) (or `AllEnterpriseModules`) is provided to AG Grid

## Topics in this Section

| Topic                                                                                         | Summary                                                      |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| This page                                                                                     | AG Grid + AdapTable items, entitlements, design-time control |
| [Column Menu Default Structure](https://www.adaptabletools.com/docs/ui-column-menu-default-structure/index.md)  | Default groups, item `name`s, and when each entry appears    |
| [Configuring the Column Menu](https://www.adaptabletools.com/docs/ui-column-menu-configuring/index.md)          | Reorder, restructure, remove with `customColumnMenu`         |
| [Custom Column Menu Items](https://www.adaptabletools.com/docs/ui-column-menu-custom-items/index.md)            | `UserColumnMenuItem` and framework menu rows                 |
| [Column Menu Technical Reference](https://www.adaptabletools.com/docs/technical-reference-column-menu/index.md) | `columnMenuOptions`, context types, `columnMenuApi`          |
| [Context Menu](https://www.adaptabletools.com/docs/ui-context-menu/index.md)                                    | Same callback pattern for right-click menus                  |

## AdapTable Menu Items

AdapTable provides a large number of Menu Entries which it inserts into the AG Grid Column Menu (see the [full default structure](https://www.adaptabletools.com/docs/ui-column-menu-default-structure/index.md)).

The Menu Items which are available in each Column vary depending on the column's data type and the current AdapTable State.

Most Menu Items are column-specific, but some relate to the Grid as a whole

Each Menu Entry is associated with a different [Module](https://www.adaptabletools.com/docs/technical-reference-adaptable-modules/index.md) to give Developers control over its visibility.

Developers are able to specify which (if any) AdapTable menu items appear.

## AG Grid Menu Items

AdapTable supports the AG Grid Column Menu and all the AG Grid provided items are still available.

Unlike with the [Context Menu](https://www.adaptabletools.com/docs/ui-context-menu/index.md), AdapTable doesn't make any changes to the AG Grid menu items

## Configuring the Column Menu

The Column Menu can be configured at design-time to meet users' requirements.

This is done via the `customColumnMenu` property in [Column Menu Options](https://www.adaptabletools.com/docs/technical-reference-column-menu/index.md), which can be used to arrange the Column Menu in multiple ways:

- **reorder** Menu Items
- **restructure** Menu Items
- **remove** Menu Items
- **add** Custom Menu Items

See [Configuring the Column Menu](https://www.adaptabletools.com/docs/ui-column-menu-configuring/index.md) and [Adding Custom Column Menu Items](https://www.adaptabletools.com/docs/ui-column-menu-custom-items/index.md) for full details of these topics

### FAQ

**How does AdapTable relate to AG Grid here?**
AG Grid renders the column menu. AdapTable supplies extra items and lets you reshape the combined menu in **`customColumnMenu`**. Use **`defaultAdaptableMenuStructure`** / **`defaultAgGridMenuStructure`** for the default trees, or **`defaultAdaptableMenuItems`** / **`defaultAgGridMenuItems`** for flat lists.

**How do I hide or reorder AdapTable items?**
Implement **`customColumnMenu`** — filter by `name`, reorder arrays, or rebuild groups. Item ids are listed on [Column Menu Default Structure](https://www.adaptabletools.com/docs/ui-column-menu-default-structure/index.md).

**Can I add my own menu entries?**
Yes — return **`UserColumnMenuItem`** entries from the same callback, or see [Custom Column Menu Items](https://www.adaptabletools.com/docs/ui-column-menu-custom-items/index.md).

**Why are some items missing?**
Check **`customColumnMenu`**, column type / layout conditions on the default structure page, and [Entitlements](https://www.adaptabletools.com/docs/handbook-permissioning/index.md) (_Hidden_ modules do not contribute items).

**Is there a way to make the 3 vertical dots for the menu always visible in the Column Header?**
Yes, via AG Grid — set `suppressMenuHide` to **true** in GridOptions.
