Welcome to the documentation for Escher

Escher is a web-based tool for building, viewing, and sharing visualizations of metabolic pathways. These ‘pathway maps’ are a great way to contextualize metabolic datasets. The easiest way to use Escher is to browse and build maps on the Escher website. New users may be interested in the Getting started with Escher visualizations guide. Escher also has a Python package and, for developers, a NPM package.

Escher in 3 minutes


  1. View pathway maps in any modern web browser

  2. Build maps using the content of genome-scale metabolic models

  3. Visualize data on reactions, genes, and metabolites

  4. Full text search

  5. Detailed options for changing colors, sizes, and more, all from the web browser

  6. View maps inside a Jupyter Notebook with Python

  7. Embed maps within any website, with minimal dependencies (escher.js, d3.js, and optionally Twitter Bootstrap)

Supported browsers

We recommend using Google Chrome for optimal performance, but Escher will also run in the latest versions of Firefox, Internet Explorer, and Safari (including mobile Safari).

Citing Escher

Please consider supporting Escher by citing our publication when you use Escher or EscherConverter:

Zachary A. King, Andreas Dräger, Ali Ebrahim, Nikolaus Sonnenschein, Nathan E. Lewis, and Bernhard O. Palsson (2015) Escher: A web application for building, sharing, and embedding data-rich visualizations of biological pathways, PLOS Computational Biology 11(8): e1004321. doi:10.1371/journal.pcbi.1004321