The file format specification defines in human and machine readable format valid Sketch document JSON, and how this changes over time. The specification is written using the JSON Schema open standard, and published in a variety of formats via npm.

Use the specification to build robust low level integrations of Sketch such as server and command-line applications. The specification is versioned independantly of Sketch itself and advances every time there’s a change to the document structure.


JSON Schema

The core specification is published as JSON Schema from the sketch-file-format package.

Use the JSON Schema to generate types, GraphQL schemas and model code or validate Sketch documents you create and manipulate programmatically.


The TypeScript types are generated automatically from the JSON Schema, and published via the sketch-file-format-ts package.

Use the types to strongly type data representing Sketch document objects, such as layers and artboards in TypeScript projects.

See something wrong or incomplete? Improve this page.