Reference
Link check
Find every cross-link in your articles and guides that points at deleted or unpublished content, so operators never follow a link to nothing.
Link check scans every article and guide in your agency for links to other ROK content and reports the ones that lead nowhere. Open it from the sidebar: Reports → Link check. The sidebar shows it to people who hold Edit content or Publish.
It checks internal cross-links only — the links the editor's link tool inserts when you link to another item. Links to websites are not checked, and checklists and quizzes are not scanned.
Why it matters
Operators' devices hold only published content. A link to an item that was deleted, or that is still a draft, opens nothing in the field — and the field is where nobody can stop to ask why. The editor catches these as you write; this page catches the ones that went wrong after publishing, when the target was deleted, withdrawn or replaced.
Reading the report
The page opens with "Checking links…" while it scans. Then:
- All clear: "No broken cross-links — N articles and guides checked."
- Problems found: a count ("N of M scanned items have link problems"), then one card per item with problems. Published items are listed first, because those are live on operators' devices.
Each card names the item that contains the link (select its title to open it), its type and status, and every faulty link inside it:
| Line | Means |
|---|---|
| Links to deleted content with a short id, in red | The target is not in your agency's content. Usually it was deleted; a link copied in from elsewhere looks the same |
| Links to title with a status badge | The target exists but is not published. Operators will not have it until it is |
Which problems block publishing
The same check runs in the article and guide editor while you write, with different weight for the two problems:
| Problem | In the editor |
|---|---|
| Link to deleted content | Blocks. "N internal links point to content that no longer exists." Publish and scheduling are disabled until it is fixed |
| Link to unpublished content | Warns. "Links to unpublished content: … — operators won't see the target until it's published." You can still publish |
A dangling link blocks because the content is wrong as written. A link to unpublished content may be deliberate — for example, two items you plan to publish together — so it only warns.
Fixing a problem
- Select the item's title to open it in the editor.
- Either edit the link so it points at the right item, or remove it — or, for an unpublished target, select the target's title on the report and publish it if it is ready.
- Select Save changes. A published item stays published. If you hold Publish and the item needs no two-person sign-off, the corrected text reaches operators at their next sync; otherwise it is held until someone with Publish releases it from the item's Changes since last publish card.
Imports from the ROK content library re-point links between library items at your copies, or remove links to items you did not import. Items imported before that change can still carry links to the library's copies; they show here as links to deleted content. Re-point them at your imported items. See Library.
When the report updates
The scan runs each time you open the page, against the content your console has loaded. After fixing links, reload the page to re-check.
See also
- ReferenceThe content editorEvery card, field and button on an item's edit page — save, submit for review, publish, schedule, unpublish, restore — who can use each, and what operators receive.
- How it worksHow publishing worksThe path a piece of content takes from a blank draft to something an operator can read offline — and what the database will and won't let you skip.
- How it worksHow offline reading worksHow the operator app works with no mobile signal — why reading never waits for the network, and what a sync does when one is available.
- ReferenceLibraryBrowse the ROK content library, preview a guide or item before you take it, and import your own editable copy into your agency as drafts.