What is canopy.json?
Maps · Updated Jun 22, 2026
canopy.json is a portable map file with nodes and edges that Canopy can import into the visual canvas.
A canopy.json file is a JSON object that describes a map as structured data. At minimum, it needs a nodes array. Edges are optional but recommended when you already know how services connect. See import from canopy.json for the paste flow.
Use it when you want architecture-as-code, generated maps, or a hand-written file that the canvas can render and edit. The full node and edge schema lives in map syntax.
Related articles
How do I create my first map?
MapsStart from a blank canvas, import a repo, paste canopy.json, or clone a template. Each path lands on the same editable map.
How does repo import work?
MapsRepo import scans a connected GitHub repository and drafts a map from detected services, frameworks, and dependencies.
What happens when I delete a map?
MapsDeleting a map you own removes it and its nodes and edges. If the map has been sold, it is archived instead so buyers keep access.