Schema and snapshots

SpatialOS concepts: Schema and snapshots


Schema is a set of definitions which represent your game’s objects in SpatialOS as entities. Schema is defined in .schema files and written in schemalang by the GDK.

Select Schema from the GDK toolbar and the GDK generates schema files and their contents for you, so you do not have to write or edit schema files manually.

SpatialOS uses schema to generate APIs specific to the entity components in your project. You can then use these APIs in your game's worker types so their instances can interact with entity components.

You can find out how to use schema in the schema reference documentation


A snapshot is a representation of the state of a SpatialOS world at a given point in time. It stores each persistent entity and the values of their SpatialOS components properties.

You can find out how to use snapshots in the snapshot reference documentation.

2019-06-27 Page updated with limited editorial review

Updated about a year ago

Schema and snapshots

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.