Skip to main content
By default, link columns display the linked item’s ID as a clickable hyperlink. The link URL is provided through a _link postfix property (e.g., a column with binding requirement uses requirement_link for the URL).

Step 1: Show ID and Title Together

To display both the work item ID and another property (such as title) in a single column, use the bindings configuration:
{
  "columns": [
    {
      "id": "mitigationTask",
      "binding": "task",
      "header": "Mitigation",
      "type": "taskLink",
      "bindings": {
        "property": "title"
      },
      "width": 250
    }
  ]
}
This renders the link with the bound property value instead of just the ID. For multiItemLink columns, each linked item is rendered as a separate entry with a tooltip showing the full ID and title:
{
  "columns": [
    {
      "id": "safetyReqs",
      "binding": "safetyReq",
      "header": "Safety Requirements",
      "type": "multiItemLink",
      "width": 250
    }
  ]
}
Each item in the list displays:
  • The item label (typically the ID)
  • A tooltip with the full ID and title
  • An asterisk prefix (*) for newly created items that have not been saved
diagram
Items created in the current session but not yet saved to the server are prefixed with an asterisk (*) and styled with a distinct CSS class. This visual indicator helps distinguish between saved and unsaved links.
For complex link display requirements (such as showing properties from indirectly linked items), use serverRender to generate HTML via Velocity scripts:
{
  "columns": [
    {
      "id": "indirectLinks",
      "binding": "indirectLinks",
      "header": "Related Items",
      "serverRender": "indirectLinksRenderer",
      "width": 200
    }
  ]
}
Columns with serverRender automatically become read-only. Use this approach only for display-only columns where you need access to Polarion’s full data model for rendering.
Apply custom CSS classes to link columns using the cellCss property:
{
  "columns": [
    {
      "id": "reqLink",
      "binding": "requirement",
      "header": "Requirement",
      "type": "itemLink",
      "cellCss": "link-column-highlight",
      "width": 150
    }
  ],
  "styles": {
    ".link-column-highlight": "{font-weight: 600; color: #3f51b5;}"
  }
}
Link columns are handled differently during export:
Export FormatRendering
ExcelPlain text (HTML stripped), multi-item links separated by newlines
PDFPlain text labels, multi-item links as formatted lists
For PDF exports, the mainSheetCellFormatter strips HTML from link columns and renders them as plain text. Multi-item links display the label property of each linked item.

Verification

Save the configuration and reload your Risksheet. You should now see linked items displayed with your custom rendering. Hover over link cells to verify tooltips show the expected information. For multi-item link columns, confirm that all linked items are visible as separate entries in the cell.

See Also

KB ArticlesSupport TicketsSource Code
  • CellPreviewFormatter.ts
  • ExportToExcel.ts
  • MultiItemLinkEditor.ts
  • RiskSheetContextMenu.ts
  • ExportToPdf.ts