Add or manage C4 Diagram Set
This page describes the lifecycle operations for a C4 Diagram Set in the Repository Model. A Diagram Set is the container that groups the related C4 Diagrams for one software system, so how you add, change, and remove sets decides how well your architecture story stays connected.

Animated walkthrough: Action > Delete on Contoso Legacy Order Landscape, then Yes: the set leaves the list. Include deleted shows it with a Deleted badge; Action > Restore and Yes bring it back with its diagram.
Understanding the Set Lifecycle
restorable"] SoftDelete --> Delete["fa:fa-trash-xmark Permanently Delete"] style SoftDelete fill:#FFD525 style Delete fill:#c33d34,color:#fff
Everyday work cycles through add, edit, import, and view; Delete (yellow) can be restored, and Permanently Delete (red) is the only irreversible operation.
| Operation | Purpose |
|---|---|
| Add Diagram Set | Create a new architecture container |
| Edit Set Properties | Change the Name, Description, Web Site, Tags, Set Mode, and the Roles that may read or change the set |
| Import | Bring diagram source into a set |
| New 7.12 Generate from Integration Landscape, C4 Dynamic on a BPM | Generate diagrams into a set. Navigation between them is inferred, so there is nothing to sync (Navigation Between C4 Diagrams) |
| View | Open and inspect set content |
| Delete and Restore New 7.12 | Remove a set and its diagrams from the lists, and bring them back |
A Diagram Set has no owner field: who may read or change it is decided by the Roles on its Roles card, each with its C4 Diagram Set permissions, and at least one Role is required (see Role-Based Access for C4 Diagram Sets). Changing Set Mode (Free Draw or Layered) on a set that already has diagrams needs a tick to confirm.
Delete and Restore
- Open Repository > Diagram Sets.
- On the set's row, choose Action > Delete (or tick several sets and use With Selected), then Yes. The set and its diagrams leave the lists.
- To find a deleted set, tick Include deleted: it shows with a Deleted badge.
- Choose Action > Restore, then Yes. The set is back with its diagrams.
Permanently Delete is a separate action, and it is refused while the set still holds diagrams.
Governance Guidance
Use Permanently Delete only when retention and governance rules allow permanent removal; Delete keeps a way back. For everyday set changes, prefer the edit, import, and view workflows.
Scope and Mode Governance
When you set up or edit a set, treat Architecture Scope as the architectural identity of each diagram (see Diagram Set Fundamentals). Choose the mode intentionally:
- Layered Mode for scope-driven architecture continuity across C4 levels.
- Free Draw for local edits that must not affect other Draft diagrams.
Changing a diagram's scope can re-evaluate inferred navigation and layered relationships. Manual links remain author-controlled.
Where to Perform These Actions
- Business and technical users follow the guided flow in Getting Started: Add or manage C4 Diagram Set.
- Administrators apply role and governance controls in Administer C4 Diagram Sets and Role-Based Access for C4 Diagram Sets.