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

# Update a Work Item

> This guide shows you how to edit existing work item fields inline in the Nextedy POWERSHEET sheet view, track your changes, and save them back to 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>;
};

## Prerequisites

* A powersheet document with loaded data
* Your user account must have update permissions for the target fields
* The fields you want to edit must have `updatable: true` in the data model (the default)

<Steps>
  <Step title="Select and Edit a Cell">
    Click on a cell to select it. Double-click or start typing to enter edit mode. Depending on the field type, you will see one of these editors:

    To inspect a row in Polarion's native work item form, use the **Open in form** action (<img src="https://mintcdn.com/none-17b4493f/KGc-UcQNrDeK-NiS/powersheet/images/48001275640/7.png?fit=max&auto=format&n=KGc-UcQNrDeK-NiS&q=85&s=739e59aa2ab85fce128ee0ef3c9001a7" alt="Open in form icon (square with an arrow pointing up-right) used in the Powersheet work items tree to open the selected work item in its native Polarion form" style={{ display: "inline", verticalAlign: "middle", height: "1.2em" }} width="50" height="46" data-path="powersheet/images/48001275640/7.png" />) on the work items tree. The Polarion form opens in a new tab, leaving your unsaved changes in the sheet intact.

    | Field Type                      | Editor Behavior                     |
    | ------------------------------- | ----------------------------------- |
    | Text / String                   | Inline text input                   |
    | Enum                            | Dropdown with available options     |
    | Integer / Float / Currency      | Numeric input                       |
    | Reference (navigation property) | Picker with search                  |
    | Read-only / Calculated          | No editing allowed (cursor changes) |

    <Note title="Read-only fields">
      Fields marked with `updatable: false` in the data model, system fields like `id` and `outlineNumber`, and server-rendered properties cannot be edited. The cell will not enter edit mode when clicked.
    </Note>
  </Step>

  <Step title="Modify Field Values">
    Type the new value and press `Enter` to commit the edit. The cell is marked as modified, and the row header shows a visual change indicator.

    For **enum fields**, the dropdown automatically filters available options based on the entity context (project, work item type, and enumeration scope). Select the desired option from the list.

    For **reference fields** (navigation properties), a picker opens where you can search for related entities by title or ID.

    ```yaml theme={null}
    # Example: Making severity editable in the data model
    domainModelTypes:
      UserNeed:
        polarionType: user_need
        properties:
          severity:
            updatable: true
            readable: true
    ```
  </Step>

  <Step title="Use Undo and Redo">
    If you make a mistake, use undo and redo to navigate your edit history:

    * **Undo**: `Ctrl+Z` -- reverts the last change
    * **Redo**: `Ctrl+Y` -- re-applies the last undone change

    The undo stack tracks all operations including cell edits, row additions, and row deletions. Undoing all changes disables the **Save** button.

    <Frame>
      <img src="https://mintcdn.com/none-17b4493f/-WiVljKlDztH36bB/powersheet/diagrams/guides/save-operations/update-work-item/diagram-1.svg?fit=max&auto=format&n=-WiVljKlDztH36bB&q=85&s=fc2f59629e1c192b348a7f9de74fcfa8" alt="diagram" style={{ width: "480px", maxWidth: "100%" }} width="480" height="80" data-path="powersheet/diagrams/guides/save-operations/update-work-item/diagram-1.svg" />
    </Frame>
  </Step>

  <Step title="Review Changes">
    Enable **review mode** by clicking the review toggle in the toolbar. The sheet filters to display only modified rows. The toolbar shows the count of changed rows (e.g., "Changed rows: 3").

    Individual cells that have been modified show a visual indicator, and the row header displays the modification state.
  </Step>

  <Step title="Save Changes">
    Click **Save** to persist all pending changes. The save operation:

    1. Validates all modified entities
    2. Saves entities one by one in dependency order
    3. Clears the undo stack on success
    4. Restores the sheet to its normal editing state

    <Warning title="Save blocked on error state">
      If the sheet has an active error state, the save is blocked with a message: "There is an error in the app and save should not happen. Please, reload the browser." Reload the page and try again.
    </Warning>
  </Step>

  <Step title="Verify">
    You should now see the updated values reflected in the sheet. The row headers no longer show the modified indicator, and the **Save** button is disabled.

    <Tip title="Copy and paste">
      You can copy and paste cell values using `Ctrl+C` and `Ctrl+V`. Pasting across different hierarchy levels is not supported -- the sheet will display a warning if you attempt it.
    </Tip>
  </Step>
</Steps>

## See Also

* [Create a Work Item](/powersheet/guides/save-operations/create-work-item) -- add new work items to the sheet
* [Handle Validation Errors](/powersheet/guides/save-operations/handle-validation-errors) -- resolve errors that occur during save
* [Set Entity Permissions](/powersheet/guides/data-model/set-permissions) -- control field-level `readable` and `updatable` settings
* [Configure Read-Only Column](/powersheet/guides/sheet-configuration/configure-read-only-column) -- make specific columns non-editable

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