Skip to main content

Configure Column Visibility in JSON

Set the visible property on any column definition in your risksheet.json to control whether it appears in the grid by default:
{
  "columns": [
    {
      "id": "severity",
      "binding": "sev",
      "header": "Severity",
      "visible": true
    },
    {
      "id": "internalNotes",
      "binding": "customField_notes",
      "header": "Internal Notes",
      "visible": false
    }
  ]
}
When visible is set to false, the column is hidden from the grid display and does not affect layout calculations. The default value is true — columns are visible unless explicitly hidden. Hidden columns are useful for:
  • Auxiliary data used by formulas but not displayed to users
  • Sort-only columns (such as a zero-padded outline number)
  • Fields that should not appear in any view

Use “Select Visible Columns” at Runtime

Users can toggle column visibility directly in the Risksheet interface without editing configuration:
  1. Open the Risksheet context menu
  2. Select Select visible columns
  3. Check or uncheck columns to show or hide them
  4. Close the dialog to apply changes
These selections persist on the user’s computer across page reloads, giving each user individual control over their view.
Personal column visibility selections made through “Select visible columns” are reset when you switch to a different saved view. If you need consistent visibility across sessions, use saved views instead.

Save and Reset Personal Column Settings

After adjusting column widths and visibility to your preference, you can persist them as personal settings:
  1. Configure your preferred column widths and visibility
  2. Open the context menu and select Save columns
  3. Confirm the save when prompted
These personal settings are stored per-user and persist across browser sessions. To restore the original column layout defined in the Risksheet template:
  1. Open the context menu and select Reset columns
  2. Confirm the reset when prompted
  3. The grid refreshes automatically, restoring default widths and visibility
diagram

Use Saved Views for Column Presets

Saved views provide administrator-defined column visibility presets that all users can switch between. Configure them in the views array of your risksheet.json:
{
  "views": [
    {
      "name": "FMEA Overview",
      "columns": ["id", "title", "severity", "occurrence", "detection", "rpn"]
    },
    {
      "name": "Traceability",
      "columns": ["id", "title", "requirement", "testCase", "mitigation"]
    }
  ]
}
Each view specifies which column id values are visible when the view is active. All other columns are hidden. Users switch between views using the view selector in the Risksheet toolbar.
Saved views are defined by administrators in the configuration and are available to all users. They are the recommended approach for controlling column visibility consistently. Personal “Select visible columns” settings are local to each user’s browser and reset when switching views.

Toggle Review Columns

Risksheet provides a dedicated toggle for review-related columns. When review mode is activated:
  • The system reviews column becomes visible
  • The add-reviews column becomes visible
  • Row heights automatically adjust to accommodate review content
Toggle review columns through the review toolbar button. The visibility state toggles between shown and hidden with each click.

Header Group Collapsing

Columns grouped under a shared headerGroup can be made collapsible using collapseTo. When collapsed, the group shows only the target column:
{
  "columns": [
    {
      "id": "sev",
      "header": "Severity",
      "headerGroup": "Initial Rating",
      "collapseTo": "rpn"
    },
    {
      "id": "occ",
      "header": "Occurrence",
      "headerGroup": "Initial Rating",
      "collapseTo": "rpn"
    },
    {
      "id": "rpn",
      "header": "RPN",
      "headerGroup": "Initial Rating",
      "formula": "commonRpn"
    }
  ]
}
The collapseTo state resets on every page reload. For persistent column hiding, use saved views or the “Select visible columns” feature instead.

Formula Columns and Visibility

Formula columns do not execute their calculations when hidden from the Risksheet view. If a formula column (such as a title column) is hidden during item creation, the Polarion work item may receive an incorrect value. Keep formula columns visible during item creation, or use the Check stored formulas feature (v24.5.1+) to reconcile formula values after making columns visible again.

Verification

After configuring column visibility, you should now see:
  • Only columns marked visible: true displayed in the grid
  • Hidden columns excluded from the layout with no empty gaps
  • Personal visibility selections persisting after page reload
  • Saved views switching the visible column set when selected from the toolbar

See Also


KB ArticlesSupport TicketsSource Code
  • ToggleReviewCommand.ts
  • ColumnsHelper.ts
  • AppConfig.ts
  • ExportToPdf.ts
  • ResetColumnsCommand.ts