Skip to main content

​
Prerequisites

  • Access to the risksheet.json configuration file for your document
  • Administrator or configuration editor permissions
  • A Risksheet document with enough columns to require horizontal scrolling

​
Understanding Freeze Panes in Risksheet

When your Risksheet has many columns (common in FMEA analyses with severity, occurrence, detection, RPN, mitigation tasks, and traceability columns), horizontal scrolling becomes necessary. Without freeze panes, the leftmost identifier columns scroll out of view, making it difficult to know which risk item you are editing. diagram
Freeze pane configuration support depends on your Risksheet version. The exact property name and behavior should be verified in your environment.

​
Step 1: Identify Columns to Freeze

Determine which columns should remain visible during horizontal scrolling. Typically, you freeze:
  • The row header (always visible by default)
  • The item ID column
  • The primary descriptor column (e.g., failure mode name, hazard description)
Review your current column configuration in risksheet.json to identify the column IDs for the columns you want to freeze.

​
Step 2: Configure the Freeze Position

Open your risksheet.json configuration file. The freeze pane setting determines how many columns from the left remain fixed when scrolling horizontally.
Consult the Risksheet configuration editor or your administrator for the exact property name used to set the freeze pane position. The property may be set at the global level or per-view level.

​
Step 3: Adjust Column Order

Freeze panes work on the leftmost columns in the grid. If the columns you want to freeze are not at the left edge, reorder your columns array in risksheet.json so that the columns you want frozen appear first. 
{
  "columns": [
    {
      "id": "systemItemId",
      "header": "ID",
      "binding": "systemItemId",
      "type": "string",
      "readOnly": true
    },
    {
      "id": "title",
      "header": "Failure Mode",
      "binding": "title",
      "type": "string"
    },
    {
      "id": "severity",
      "header": "Severity (S)",
      "binding": "severity",
      "type": "rating:severity"
    }
  ]
}
In this example, if the freeze position is set to 2, the systemItemId and title columns remain visible while all subsequent columns (starting with severity) scroll horizontally.

​
Step 4: Consider Column Widths

Frozen columns consume horizontal space permanently. If you freeze too many wide columns, the scrollable area becomes too narrow for comfortable editing.
RecommendationGuideline
Number of frozen columns1-3 columns maximum
Total frozen widthNo more than 30-40% of the viewport width
Frozen column widthsUse the width and minWidth properties to keep frozen columns compact
{
  "columns": [
    {
      "id": "systemItemId",
      "header": "ID",
      "binding": "systemItemId",
      "width": 80,
      "minWidth": 60
    },
    {
      "id": "title",
      "header": "Failure Mode",
      "binding": "title",
      "width": 200,
      "minWidth": 150
    }
  ]
}
If frozen columns consume too much horizontal space, users on smaller screens or lower resolutions may have very little room for the scrollable columns. Test your configuration at different screen sizes.

​
Step 5: Test with Saved Views

If you use saved views that change column visibility, verify that freeze panes work correctly when switching between views. Hiding or showing columns may affect which columns are in the frozen region.
Keep identifier columns (ID, title) at the leftmost position across all saved views to ensure freeze panes remain useful regardless of which view is active.

​
Verification

After applying the freeze pane configuration:
  1. Reload the Risksheet page to apply the new configuration.
  2. Scroll horizontally using the scrollbar at the bottom of the grid.
  3. Verify that the configured columns remain fixed on the left side.
  4. Verify that all scrollable columns can be reached and edited normally.
  5. Test at different browser window widths to ensure the frozen region does not consume excessive space.
You should now see the frozen columns remain stationary while the rest of the grid scrolls horizontally, keeping your key identifier columns visible at all times.

​
See Also