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

# Link Rendering Issues

> Diagnose and fix broken or missing link rendering in item link, multi-item link, and task link columns.

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>;
};

## Symptoms

Link rendering issues manifest in several ways:

* Item link columns display raw IDs instead of formatted hyperlinks
* Links break after editing adjacent columns
* Links become unclickable when the column filter or search is active
* Multi-item link columns show raw JSON instead of formatted item labels

## Understand How Link Rendering Works

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/t34k0QhMnn4JCqkc/risksheet/diagrams/troubleshooting/link-rendering-broken/diagram-1.svg?fit=max&auto=format&n=t34k0QhMnn4JCqkc&q=85&s=1185e85f9c62d719961c1caa02d9118f" alt="diagram" style={{ maxWidth: "580px", width: "100%" }} width="580" height="200" data-path="risksheet/diagrams/troubleshooting/link-rendering-broken/diagram-1.svg" />
</Frame>

Item link columns use a `_link` postfix property (e.g., for a column with binding `requirement`, the HTML content comes from `requirement_link`). When this property is empty or missing, the cell falls back to displaying the raw value.

## Fix Broken Links After Editing

Link rendering can break when editable columns are modified alongside rendered link columns in the same save operation.

1. Check whether the issue occurs only after editing specific columns
2. If link columns break after saving edits to adjacent columns, configure `refreshOnSave` in the `global` section of your sheet configuration:

```yaml theme={null}
global:
  refreshOnSave: true
```

<Warning title="refreshOnSave Behavior">
  Setting `refreshOnSave` to `false` prevents page reload after save, which can leave link columns displaying stale or broken HTML. If you experience link rendering issues after save, ensure `refreshOnSave` is set to `true` (the default).
</Warning>

## Fix Multi-Item Link Display Issues

Multi-item link columns store data as a JSON array of `{id, label, title}` objects. Each item displays as a separate entry with a title tooltip showing the full ID and title.

If multi-item links display incorrectly:

1. Verify the column is configured with the correct type (e.g., `multiItemLink`)
2. Check that the underlying Polarion field contains valid JSON array data
3. Confirm that linked items are accessible in the target project

<Tip title="New Items Display with Asterisk">
  Newly created items that have not yet been saved display with an asterisk (`*`) prefix. This is expected behavior and the asterisk disappears after saving.
</Tip>

## Fix Item Link Columns Showing Raw Values

If item link columns show raw IDs instead of clickable links:

1. Verify the column definition includes the correct `bindings` property
2. Check that the linked work item exists and is accessible
3. Review the column type -- item link columns should use the appropriate column type attribute

| Column Type     | Expected Behavior              | Common Issue                         |
| --------------- | ------------------------------ | ------------------------------------ |
| `itemLink`      | Clickable link with item label | Missing `_link` property from server |
| `multiItemLink` | List of clickable links        | Invalid JSON in cell value           |
| `taskLink`      | Clickable task reference       | Task item not accessible             |

## Fix Server Error: "no id when getting links"

If you see the error `no id when getting links` in server logs, a work item referenced in a link column is missing its ID. This typically occurs when:

* A linked work item was deleted from Polarion
* Cross-project link references point to items in inaccessible projects
* The work item data is corrupted

Review the server logs to identify which specific item reference is causing the error, then remove or update the broken link in the Nextedy RISKSHEET grid.

## Verify the Fix

After applying corrections:

1. Refresh the Risksheet page
2. Click on a link column cell to verify the link is rendered as a clickable hyperlink
3. Edit a cell in an adjacent column, save, and confirm that link columns still render correctly

You should now see all link columns displaying formatted, clickable hyperlinks with proper item labels and tooltips.

## See Also

* [Rendering and Display Errors](/risksheet/troubleshooting/rendering-errors)
* [Cell Editing Issues](/risksheet/troubleshooting/cell-editing-issues)
* [Save Operation Failures](/risksheet/troubleshooting/save-failures)

<LastReviewed date="2026-06-18" />
