# Configurator
URL: https://pro.rv-grid.com/guides/pivot/configurator/configurator/
Source: src/content/docs/guides/pivot/configurator/configurator.mdx
Description: Learn what the Pivot configurator does and how users interact with rows, columns, and values.
The configurator is the drag-and-drop field panel for Pivot. It gives users a visual way to rearrange dimensions between rows, columns, and values without writing a new `PivotConfig` by hand.

## What It Does

The configurator renders:

- a dimension list
- a rows drop zone
- a columns drop zone
- a values drop zone

When users move a field:

- the configurator emits updated rows, columns, or values
- `PivotPlugin` re-emits `pivot-config-update`
- the Pivot result is recomputed and the grid updates

## Enable It

```ts
const pivot: PivotConfig = {
  dimensions: [...],
  rows: ['region'],
  columns: ['quarter'],
  values: [{ prop: 'sales', aggregator: 'sum' }],
  hasConfigurator: true,
};
```

## Visibility Controls

Use these options to hide zones:

- `showRows`
- `showColumns`
- `showValues`

These only affect the configurator UI. They do not remove support for the corresponding Pivot feature.

## Mounting

By default, `PivotPlugin` creates the configurator inside the grid wrapper. If you set `mountTo`, it mounts into the supplied element instead.

## Aggregator Selection

The configurator’s value zone reads available aggregators from the matching dimension. That means aggregator choices stay consistent with the field definition, rather than being hard-coded in the panel.

## i18n

Configurator labels come from `i18n`. If omitted, Pivot uses the built-in English defaults from `PIVOT_CONFIG_EN`.

## Common Mistakes

- Enabling `hasConfigurator` without providing useful `dimensions`.
- Expecting hidden zones to disable Pivot features globally.
- Treating the configurator as the state owner. It is a UI for editing Pivot state, not the persistence layer.

## Next

Continue with [Field Panel](/guides/pivot/field-panel/) for the compact in-grid layout, [Configurator API](/guides/pivot/configurator-api/) for the standalone embedding surface, or [Server-Side Pivot](/guides/pivot/server-side/) for remote analytical usage.
