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. Each row then shows its edit and delete controls.

Edit a value

  • Click the tag value to open the editor.
  • The value is checked against its VR (Value Representation), and invalid syntax is flagged in red.
  • Hit ↵ to commit. The dirty counter in the TopBar increments.

Long arrays & binary payloads

Two kinds of value open in their own modal instead of the single-line editor:

  • 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 shows the byte length, and you can replace the raw payload without converting it to text.

⌘Z reverts both 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. Text is written as UTF-8 (ISO_IR 192), and a value marked undecodable, or any value the file’s own character set cannot encode back to the same bytes, blocks the export until you edit or delete it; see Specific Character Set.

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