The location hash property - the part after the # sign in the URL - is used to reference a diagram file stored in a specific location. It uses a leading character to specify where your file is stored, and the data - either the unique file ID, path to the file or the diagram data itself. This must be URI encoded.


For example, the following is a URL that opens a file stored at a URI-encoded URL (using the U location hash property).


https://app.diagrams.net/#Uhttps%3A%2F%2Fjgraph.github.io%2Fdrawio-diagrams%2Fdiagrams%2Fbulb.xml


The following references are supported where {id} is used for the unique file ID on your cloud storage platform, and {path} is your file’s location.

  • G{id}: Google Drive
  • W{id}: Microsoft OneDrive
  • T{id}: Trello
  • D{path}: Dropbox (path must be relative to Apps/drawio)
  • H{path}: Github (path must be in the format org/repo/branch/path)
  • A{path}: GitLab (path must be in the format org/repo/branch/path)
  • L{path}: Browser storage
  • U{url}: Opens the diagram from a URL (example). If the URL does not end with a filename, use the template-filename URL parameter to specify the filename.
  • R{data}: Passes the raw diagram data (example)
  • P{encoded-json}: Passes one or more URL parameters as a JSON object. In addition to all of the supported URL parameters, the JSON object may contain a data field that includes the diagram data, and a hash field for the new hash property to use after parsing.
  • _CONFIG_{compressed-json}: Configures the diagrams.net editor using the given compressed JSON data.
  • S{compressed-json}: Passes the import descriptor (example)
    Deprecated: Use the desc URL parameter instead.

If the location hash properties are not available, use the open URL parameter instead.