Legacy Import

Diagrammix3 can import diagrams created in earlier versions of Diagrammix, preserving your existing work.

Supported Formats

The legacy import feature supports:

FormatExtensionSource Version
Diagrammix Document.diagramDiagrammix 1.x
Diagrammix Archive.diagrammixDiagrammix 2.x
Drawing Document.drawingDiagrammix 2.x

Importing Legacy Files

Using File Menu

  1. Go to File → Import Legacy...
  2. Navigate to your legacy file
  3. Select the file and click Open
  4. The diagram opens in a new document

Drag and Drop

Simply drag a legacy file onto the Diagrammix3 icon or window.

Legacy Import Dialog

Notation Pack Detection

When importing legacy files, Diagrammix3 automatically:

  • Detects the notation packs used in the original
  • Matches them to equivalent packs in the new version
  • Alerts you if any packs are unavailable

Missing Notation Packs

If the original diagram used notation packs not available in Diagrammix3:

  • Generic shapes replace missing symbols
  • A notification lists missing packs
  • You can manually update shapes after import

What Gets Imported

Fully Supported

  • Shapes and their positions
  • Connectors and routing
  • Colors and styles
  • Groups and layers
  • Text content and formatting
  • Images and embedded graphics

Partially Supported

  • Custom shape definitions (may need adjustment)
  • Some complex gradients
  • Script-based behaviors

Not Supported

  • External file references
  • Linked databases
  • Plugin-specific features

Post-Import Steps

After importing a legacy file:

  1. Review the diagram: Check that all elements imported correctly
  2. Update notation: Replace any placeholder shapes with proper symbols
  3. Check connectors: Verify connections are attached correctly
  4. Save as new format: Save as a .diagrammix3 document

Batch Import

To import multiple legacy files:

  1. Create a new empty document for each
  2. Use File → Import Legacy... for each file
  3. Or drag multiple files onto Diagrammix3 (opens each in a new tab)

Migration Tips

Before Starting

  • Make backup copies of legacy files
  • Note which notation packs your diagrams use
  • Have the original application available for reference if needed

Common Issues

Shapes appear as rectangles

  • Missing notation pack; manually replace with equivalent shapes

Connectors disconnected

  • Re-attach to connection points on shapes

Fonts look different

  • Original font may not be installed; choose a replacement

Colors slightly off

  • Color profiles may differ; adjust in Inspector

Preserving Original Files

Legacy import creates a new document and does not modify the original file. Keep your legacy files as backup until you've verified the import is complete.

File Format Comparison

FeatureLegacy (.diagram)Current (.diagrammix3)
iCloud SyncNoYes
Version HistoryNoYes
Auto-saveNoYes
File SizeLargerOptimized
CompatibilityDiagrammix 1-2Diagrammix 3+