> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration Basics

> Configuration Basics — common questions about Nextedy POWERSHEET.

export const LastReviewed = ({date, state}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  const label = state === "reviewed" ? `Last reviewed and confirmed up to date on ${formatted}` : `Last updated on ${formatted}`;
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      {label}
    </p>;
};

<AccordionGroup>
  <Accordion title="What is a sheet configuration?">
    A **sheet configuration** is a YAML file that defines how Nextedy Powersheet displays and interacts with data from the data model. It specifies columns, data sources, views, column groups, formatters, and sorting behavior. Each Powersheet document references a sheet configuration through the `nextedySheetConfig` custom field. Configurations are managed in **Administration > Nextedy POWERSHEET > Sheet Configurations**.

    See [Creating Your First Sheet Configuration](/powersheet/getting-started/first-sheet-configuration) for a step-by-step tutorial.
  </Accordion>

  <Accordion title="How does a sheet configuration relate to the data model?">
    The sheet configuration depends on the data model for entity type definitions, relationships, and property metadata. Column binding paths in the configuration reference properties and expansion paths defined in the data model. The `model` property in the `sources` section specifies which data model to use. If the model and configuration do not match, you will see errors when loading the sheet.

    <Frame>
      <img src="https://mintcdn.com/none-17b4493f/3Zik2OH750CE3kB4/powersheet/diagrams/faq/sheet-configuration/diagram-1.svg?fit=max&auto=format&n=3Zik2OH750CE3kB4&q=85&s=2a5e4fcec17f21284590d784a75a06d9" alt="diagram" style={{ width: "520px", maxWidth: "100%" }} width="520" height="140" data-path="powersheet/diagrams/faq/sheet-configuration/diagram-1.svg" />
    </Frame>
  </Accordion>

  <Accordion title="Should I start with a complex configuration or build incrementally?">
    Start with the simplest possible configuration — a single entity type, a few columns, and one data source. Verify that the basic setup loads correctly, then extend gradually by adding relationships, column groups, and formatters. Jumping to a complex multi-entity configuration leads to difficult-to-diagnose errors.

    <Tip>
      **Best practice**

      See [Incremental Configuration Approach](/powersheet/getting-started/incremental-configuration) for a recommended step-by-step build strategy.
    </Tip>
  </Accordion>
</AccordionGroup>

<LastReviewed date="2026-09-21" />