C4 Diagrams Troubleshooting
C4 Diagrams is part of experimental builds. To access this capability, contact your sales representative.
This page covers common questions and issues encountered when working with C4 Diagrams in Nodinite. For detailed reference material, see the linked sub-pages.
Reference Pages
- C4 Model vs Nodinite Concept Mapping — Side-by-side table of C4 model terminology and how it maps to Nodinite Repository entities and properties
- Repository Properties for C4 Diagramming — Complete reference for all C4-related properties on Systems and Services, what they do, and how to set them
Frequently Asked Questions
The Actors panel in the C4 Designer is empty — why?
The Actors panel only shows Systems that have a C4Type set to Person, InternalSystem, or ExternalSystem. Systems with the default value None are hidden from the panel.
Fix: Open Repository → Systems → edit the relevant Systems → set C4Type to the appropriate value.
See Repository Properties for C4 Diagramming for the full property reference.
The Services panel shows a Service but when I drag it, no node appears
This typically means the drag target (the lane area) was not recognized. Ensure you are dragging into a lane (the swimlane body) rather than the lane header or the canvas background outside all lanes.
If no lanes exist yet, add at least one Domain lane first ( Add Lane).
The Mermaid output shows Container(...) for all nodes — no ContainerDb or ContainerQueue
The Mermaid type (Container, ContainerDb, ContainerQueue) is determined by the Service's C4ContainerType property:
Database→ContainerDb(...)MessageBus→ContainerQueue(...)- All others →
Container(...)
Fix: Set C4ContainerType = Database or C4ContainerType = MessageBus on the relevant Services. See Repository Properties for C4 Diagramming.
Person actors appear below the lane stack instead of above
The position of an actor is determined by where it was dragged on the canvas, not by C4Type alone. If a Person-type System was accidentally dropped below the lane area, it will appear there.
Fix: Drag the actor node above the top lane. The C4PositionHint property can pre-configure the default drop zone, but it does not force the position after the actor is placed.
The C4 Diagrams menu item is not visible in the Repository navigation
C4 Diagrams requires the Mapify module license. If the navigation item is absent, contact your Nodinite administrator to verify the Mapify license is active.
See Nodinite Licensing for guidance.
A Service appears in the wrong lane after loading the diagram
Each Service's lane position is saved automatically as part of the diagram. If the Service appears in an unexpected lane, it may have been dragged there by another user or a previous session.
Fix: Drag the Service node to the correct lane in the designer. The move writes an update to the database immediately.
The Mermaid View renders but all connectors are missing
Connectors are not automatically inferred from the Repository relationship graph. They must be explicitly drawn in the C4 Designer using the Connectors toolbox panel. Until connectors are drawn, no connector data exists for the diagram.
Fix: Open the diagram in the designer, use the Connectors panel to draw relationships between nodes, and enter Label and Protocol values in the Properties sidebar.
Does changing C4ContainerType on a Service affect my BPM diagrams?
No. C4ContainerType and C4Technology are used only by C4 Diagrams. BPM, Log Views, Monitor Views, and the Integration Landscape are not affected by these properties.
Can I have the same C4 Diagram save multiple layout variants (As-Is vs To-Be)?
The As-Is / To-Be toggle in the designer toolbar marks a diagram as representing the current (As-Is) or target (To-Be) architecture. Each variant is a separate diagram in the C4 Diagram list. Create two diagrams — one marked As-Is and one marked To-Be — and give them descriptive names.
The PNG export is blank or very small
The export endpoint generates the diagram from the Mermaid output via the server-side rendering engine. A blank or very small PNG typically means the diagram has no nodes placed on canvas, or the Mermaid syntax is invalid.
Fix: Open the /mermaid URL for the diagram and verify the Mermaid markup is valid. Paste it into the Mermaid Live Editor to confirm it renders correctly.