Enable Editing of Upstream Columns - Nextedy Documentation

Understanding the Default Behavior

Upstream columns are read-only by default. This protects linked items from accidental modification. To allow editing, you must explicitly override this on each column.

Step 1: Set readOnly to false

Add "readOnly": false to the upstream column definition in your risksheet.json:

{
  "columns": [
    {
      "id": "reqTitle",
      "binding": "requirement.title",
      "header": "Req. Title",
      "readOnly": false,
      "width": 250
    }
  ]
}

The readOnly property is case-sensitive. You must use "readOnly": false with an uppercase O. Using "readonly": false (all lowercase) has no effect and the column remains read-only. This is the most common configuration mistake when enabling upstream editing.

Step 2: Apply to Multiple Upstream Columns

When you have several upstream columns to make editable, add readOnly: false to each one individually:

{
  "columns": [
    {
      "id": "reqId",
      "binding": "requirement",
      "header": "Requirement",
      "type": "itemLink",
      "width": 150
    },
    {
      "id": "reqTitle",
      "binding": "requirement.title",
      "header": "Req. Title",
      "readOnly": false,
      "width": 250
    },
    {
      "id": "reqPriority",
      "binding": "requirement.priority",
      "header": "Priority",
      "type": "enum:priorityEnum",
      "readOnly": false,
      "width": 100
    }
  ]
}

Column	Editable?	Reason
`requirement` (itemLink)	Yes	Link columns allow linking/unlinking by default
`requirement.title`	No (default)	Nested properties are read-only unless overridden
`requirement.priority`	No (default)	Nested properties are read-only unless overridden

Step 3: Understand Read-Only Overrides

Even with readOnly: false, certain columns remain non-editable:

Columns with a formula property are always read-only
Columns with a serverRender property are always read-only
System fields (id, status, type, project, outlineNumber, author, resolution, created, updated) cannot be made editable
Cells where Polarion permissions deny modification remain read-only at the cell level

The toolbar delete button removes the entire row from the grid. To clear only the content of a cell (including in upstream columns), use the keyboard Delete key instead.

Step 4: Control the Link Column Separately

The link column itself (e.g., binding: "requirement" with type: "itemLink") controls the association between the risk item and the upstream item. To allow linking but prevent creation of new upstream items:

{
  "id": "reqId",
  "binding": "requirement",
  "header": "Requirement",
  "type": "itemLink",
  "canCreate": false,
  "width": 150
}

Setting canCreate to false keeps the cell active for linking and unlinking existing items while preventing new item creation.

Verification

Save the configuration and reload your Risksheet. You should now see the upstream columns without the read-only visual indicator (gray background). Click on an upstream property cell to verify it opens for editing. Make a change, save, and confirm the linked work item is updated in Polarion.

​Understanding the Default Behavior

​Step 1: Set readOnly to false

​Step 2: Apply to Multiple Upstream Columns

​Step 3: Understand Read-Only Overrides

​Step 4: Control the Link Column Separately

​Verification

​See Also

Understanding the Default Behavior

Step 1: Set readOnly to false

Step 2: Apply to Multiple Upstream Columns

Step 3: Understand Read-Only Overrides

Step 4: Control the Link Column Separately

Verification

See Also