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

> Find solutions to common Nextedy POWERSHEET configuration and runtime issues.

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>;
};

<Columns cols={3}>
  <Card title="Fix Model Connection Errors" icon="file" href="/powersheet/guides/troubleshooting/fix-model-connection-errors">
    Resolve connection failures between your sheet configuration and data model, including incorrect model paths and status issues.
  </Card>

  <Card title="Fix Type Name Errors" icon="file" href="/powersheet/guides/troubleshooting/fix-type-name-errors">
    Fix data model entity type naming issues such as spaces, special characters, and mismatched type references.
  </Card>

  <Card title="Fix Relationship Errors" icon="file" href="/powersheet/guides/troubleshooting/fix-relationship-errors">
    Troubleshoot relationship configuration problems including invalid from/to references and missing link roles.
  </Card>

  <Card title="Fix Multi-Item Column Errors" icon="list" href="/powersheet/guides/troubleshooting/fix-multi-item-errors">
    Resolve issues with multi-item columns displaying incorrectly or failing to save in many-to-many relationships.
  </Card>

  <Card title="Debug Custom Field Issues" icon="file" href="/powersheet/guides/troubleshooting/debug-custom-field-issues">
    Diagnose custom field mapping problems between Polarion fields and data model properties.
  </Card>

  <Card title="Resolve Validation Errors" icon="file" href="/powersheet/guides/troubleshooting/resolve-validation-errors">
    Identify and fix validation errors that occur during save operations, including constraint violations and data quality issues.
  </Card>
</Columns>

<Tip title="Troubleshooting approach">
  Start by identifying the error category from the message you see in the sheet. Connection and type name errors appear at load time, while validation and save errors appear when editing data. Use the [Model Helper Widget](/powersheet/guides/customization/use-model-helper) to visualize your data model structure and verify binding paths.
</Tip>

| Symptom                                                                      | Likely Guide                                                                                  |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Sheet fails to load, connection status "Failed"                              | [Fix Model Connection Errors](/powersheet/guides/troubleshooting/fix-model-connection-errors) |
| Error mentions "left" or "right" entity                                      | [Fix Relationship Errors](/powersheet/guides/troubleshooting/fix-relationship-errors)         |
| Entity type not recognized                                                   | [Fix Type Name Errors](/powersheet/guides/troubleshooting/fix-type-name-errors)               |
| Sheet loads but is empty, no error shown (often a wrong-case `polarionType`) | [Fix Type Name Errors](/powersheet/guides/troubleshooting/fix-type-name-errors)               |
| Multi-item column shows single value                                         | [Fix Multi-Item Column Errors](/powersheet/guides/troubleshooting/fix-multi-item-errors)      |
| Custom field not appearing in sheet                                          | [Debug Custom Field Issues](/powersheet/guides/troubleshooting/debug-custom-field-issues)     |
| "My new column is blank / shows no value"                                    | [Debug Custom Field Issues](/powersheet/guides/troubleshooting/debug-custom-field-issues)     |
| Save operation fails with numbered errors                                    | [Resolve Validation Errors](/powersheet/guides/troubleshooting/resolve-validation-errors)     |
| "My edits don't save" / changes are rejected on save                         | [Resolve Validation Errors](/powersheet/guides/troubleshooting/resolve-validation-errors)     |

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