Getting started

Edit DICOM tags safely

How edits, validation, undo, and export work together.

Switch to Edit mode

Click Edit in the TopBar’s mode switch. Per-row delete/edit affordances become visible.

Edit a value

  • Click the tag value to open the editor.
  • The VR (Value Representation) drives validation — invalid syntax is flagged in red.
  • Hit to commit. The dirty counter in the TopBar increments.

Long arrays & binary payloads

Not every value fits a single-line editor — the row routes to a dedicated modal automatically:

  • Long arrays — a scalar element with more than 10 values (VM > 10) opens the structured-array editor, which edits the values as a CSV / textarea list instead of one cramped input.
  • Binary payloads — a bulk-binary VR (OB / OW / UN, e.g. pixel or private blobs) opens the binary payload modal. It reports the byte length and lets you replace the raw payload directly rather than round-tripping it as text.

Both commit through the same undo pipeline, so ⌘Z reverts them like any other edit.

Undo & history

Use ⌘Z / ⌘⇧Z for linear undo/redo. Use the History tab to jump to any prior snapshot.

Review & export

  • Press ⌘E to open the diff modal.
  • Every change is listed with original vs new value.
  • Confirm to write a new DICOM file. The source is never overwritten.

    Caution Editing UIDs, modality, or other identifiers can break downstream PACS routing. If unsure, prefer the Anonymize workflow which preserves referential integrity.