# Configuration reference

This section reorganizes the configuration surface into the core objects operators reach for most often: cluster, schema, table, ingestion, job specs, metrics, dynamic environment handling, and plugin settings. Cluster and schema configuration are flattened directly into this section, and the pages here are the primary reference entry points, while some legacy material still remains in the older `configuration-reference/` tree.

## Reference Map

| Area                | Use it for                                                           | Reference page                                                                                                     |
| ------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Cluster             | Cluster-wide knobs, query protection, and broker behavior            | [Cluster](https://docs.pinot.apache.org/reference/configuration-reference/cluster)                                 |
| Schema              | Column definitions, null handling, data types, and MAP field support | [Schema](https://docs.pinot.apache.org/reference/configuration-reference/schema)                                   |
| Table               | Offline, real-time, hybrid, routing, query, and indexing config      | [Table](https://docs.pinot.apache.org/reference/configuration-reference/table)                                     |
| Ingestion           | Stream and batch ingestion settings embedded in table config         | [Ingestion](https://docs.pinot.apache.org/reference/configuration-reference/ingestion)                             |
| Job spec            | Offline ingestion job configuration and templating                   | [Ingestion Job Spec](https://docs.pinot.apache.org/reference/configuration-reference/job-specification)            |
| Monitoring metrics  | Server, broker, and controller metric configuration                  | [Monitoring Metrics](https://docs.pinot.apache.org/reference/configuration-reference/monitoring-metrics)           |
| Dynamic environment | Environment-variable substitution in config payloads                 | [Dynamic Environment](https://docs.pinot.apache.org/reference/configuration-reference/dynamic-environment)         |
| Plugin reference    | Plugin-family configuration and version guidance                     | [Plugin Configuration Reference](https://docs.pinot.apache.org/reference/configuration-reference/plugin-reference) |

## What this page covers

* The dense configuration surfaces that belong in reference.
* The flat reference pages for the most commonly used Pinot config topics.
* How to get from this landing page to the detailed config docs.

## Next step

Open the specific config page for the object you are changing, then cross-check any linked table or schema behavior before editing a table config.

## Related pages

* [Table](https://docs.pinot.apache.org/reference/configuration-reference/table)
* [Schema](https://docs.pinot.apache.org/reference/configuration-reference/schema)
* [Ingestion](https://docs.pinot.apache.org/reference/configuration-reference/ingestion)
* [Plugin Configuration Reference](https://docs.pinot.apache.org/reference/configuration-reference/plugin-reference)
* [Legacy Plugin Configuration Landing](https://docs.pinot.apache.org/reference/plugin-reference)