GoJS, a JavaScript Library for HTML Diagrams

GoJS is a JavaScript and TypeScript library for creating and manipulating diagrams, charts, and graphs.

See GoJS Samples

Get Started with GoJS

GoJS is a flexible library that can be used to create a number of different kinds of interactive diagrams, including data visualizations, drawing tools, and graph editors. There are samples for flowchart, org chart, business process BPMN, swimlanes, timelines, state charts, kanban, network, mindmap, sankey, family trees and genogram charts, fishbone diagrams, floor plans, UML, decision trees, PERT charts, Gantt, and hundreds more. GoJS includes a number of built in layouts including tree layout, force directed, circular, and layered digraph layout, and many custom layout extensions and examples.

GoJS is renders either to an HTML Canvas element (with export to SVG or image formats) or directly as SVG DOM. GoJS can run in a web browser, or server side in Node or Puppeteer. GoJS Diagrams are backed by Models, with saving and loading typically via JSON-formatted text.

Read more about GoJS at gojs.net

The GitHub repository and the GoJS website contain not only the library, but also the sources for all samples, extensions, and documentation.

However the npm package contains only the library. You can install the GoJS library using npm:

$ npm install gojs

The extensions are published separately in the gojs-extensions package:

$ npm install gojs-extensions

The samples and documentation are not on npm; they are available in the GitHub repository and on the website.

You can use the GitHub repository to quickly search through all of the sources.

Minimal Sample

Diagrams are built by creating one or more templates, with desired properties data-bound, and adding model data.

<div id="myDiagramDiv" style="width:400px; height:200px;"></div>

<script src="https://cdn.jsdelivr.net/npm/gojs"></script>

<script>
  const myDiagram = new go.Diagram('myDiagramDiv', {
    // create a Diagram for the HTML div element
    'undoManager.isEnabled': true // enable undo & redo
  });

  // define a simple Node template
  // the Shape will automatically surround the TextBlock
  myDiagram.nodeTemplate = new go.Node('Auto').add(
    // add a Shape and a TextBlock to this "Auto" Panel
    new go.Shape('RoundedRectangle', { strokeWidth: 0, fill: 'white' }) // no border; default fill is white
      .bind('fill', 'color'), // Shape.fill is bound to Node.data.color
    new go.TextBlock({ margin: 8, font: 'bold 14px sans-serif', stroke: '#333' }) // some room around the text
      .bind('text', 'key') // TextBlock.text is bound to Node.data.key
  );

  // but use the default Link template, by not setting Diagram.linkTemplate

  // create the model data that will be represented by Nodes and Links
  myDiagram.model = new go.GraphLinksModel(
    [
      { key: 'Alpha', color: 'lightblue' },
      { key: 'Beta', color: 'orange' },
      { key: 'Gamma', color: 'lightgreen' },
      { key: 'Delta', color: 'pink' }
    ],
    [
      { from: 'Alpha', to: 'Beta' },
      { from: 'Alpha', to: 'Gamma' },
      { from: 'Beta', to: 'Beta' },
      { from: 'Gamma', to: 'Delta' },
      { from: 'Delta', to: 'Alpha' }
    ]
  );
</script>

The above diagram and model code creates the following graph. The user can now click on nodes or links to select them, copy-and-paste them, drag them, delete them, scroll, pan, and zoom, with a mouse or with fingers.

Click the above image to see the interactive GoJS Diagram

Using GoJS with AI coding assistants

GoJS publishes an llms.txt primer that orients LLMs and coding agents (Claude, Copilot, Cursor, etc.) toward correct, idiomatic GoJS 4.0+ code — typed constants (go.Figures, go.Arrowheads, …), the fluent new go.Node(...).add(...) API, generic models, and common gotchas. The full, machine-readable TypeScript API surface ships in this package as gojs/release/go.d.ts.

Support

Northwoods Software offers a month of free developer-to-developer support for GoJS to prospective customers so you can finish your project faster.

Read and search the official GoJS forum for any topics related to your questions.

Posting in the forum is the fastest and most effective way of obtaining support for any GoJS related inquiries. Please register for support at Northwoods Software's registration form before posting in the forum.

For any nontechnical questions about GoJS, such as about sales or licensing, please visit Northwoods Software's contact form.

License

GoJS is commercial software, not open-source.

As of September 2026, GoJS is free for individuals for non-commercial use, such as learning and hobby projects, under the Non-Commercial Software License Agreement.

See the deployment instructions for non-commercial license keys.

Use of GoJS by or on behalf of an organization, including any company, non-profit, educational institution, or government agency, is commercial use and requires a purchased license under the software license, or private evaluation under the evaluation license.

Copyright, Northwoods Software Corporation