> ## 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.

# Troubleshooting FAQ

> Common issues and solutions when working with Nextedy POWERSHEET in Siemens Polarion ALM.

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

<Info title="Quick symptom lookup">
  Use the table below to jump directly to the most relevant troubleshooting guide for your issue.
</Info>

| Symptom                                         | Likely Cause                                    | Guide                                                                                         |
| ----------------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Sheet fails to load, connection status "Failed" | Data model path or syntax error                 | [Fix Model Connection Errors](/powersheet/guides/troubleshooting/fix-model-connection-errors) |
| Entity type not recognized                      | Case mismatch or missing `domainModelTypes` key | [Fix Type Name Errors](/powersheet/guides/troubleshooting/fix-type-name-errors)               |
| Relationship errors or missing navigation       | Invalid `direct`/`back` names or link role      | [Fix Relationship Errors](/powersheet/guides/troubleshooting/fix-relationship-errors)         |
| Multi-item column shows single value            | Missing `multiItem: true` on column             | [Fix Multi-Item Column Errors](/powersheet/guides/troubleshooting/fix-multi-item-errors)      |
| Custom field not appearing in sheet             | Property not declared in data model             | [Debug Custom Field Issues](/powersheet/guides/troubleshooting/debug-custom-field-issues)     |
| Save operation fails with validation errors     | Constraint violation or data issue              | [Resolve Validation Errors](/powersheet/guides/troubleshooting/resolve-validation-errors)     |

<Columns cols={2}>
  <Card title="Loading and Display Issues" icon="circle-question" href="/powersheet/faq/troubleshooting/loading-and-display-issues">
    Why does my Powersheet show a blank or empty sheet?
  </Card>

  <Card title="Configuration Issues" icon="circle-question" href="/powersheet/faq/troubleshooting/configuration-issues">
    Why does my sheet configuration fail to load?
  </Card>

  <Card title="Data Model Issues" icon="circle-question" href="/powersheet/faq/troubleshooting/data-model-issues">
    Why do I get errors about entity types not being found?
  </Card>

  <Card title="Administration and Setup Issues" icon="circle-question" href="/powersheet/faq/troubleshooting/administration-and-setup-issues">
    How do I access the Powersheet administration interface?
  </Card>

  <Card title="Data and Save Issues" icon="circle-question" href="/powersheet/faq/troubleshooting/data-and-save-issues">
    Why does saving data fail with validation errors?
  </Card>
</Columns>

<AccordionGroup>
  <Accordion title="Still stuck?">
    If your issue is not covered above, try the full [Troubleshooting Guides](/powersheet/guides/troubleshooting/index) for step-by-step walkthroughs, or browse the other FAQ pages:

    * [General FAQ](/powersheet/faq/general) -- product overview and capabilities
    * [Configuration FAQ](/powersheet/faq/configuration) -- sheet configuration questions
    * [Data Model FAQ](/powersheet/faq/data-model) -- data model and entity type questions
    * [Licensing FAQ](/powersheet/faq/licensing) -- license and access questions
  </Accordion>
</AccordionGroup>

<LastReviewed date="2026-07-08" />