Document root - ScreenJSON

Required
Optional
document container
cover
bookmarks

Required

Field	Type	Description
`id`	uuid	RFC 4122 document identifier.
`version`	string	Semver. Pins the schema version the document was authored against.
`title`	name	Document title, language-keyed.
`lang`	lang	Primary BCP 47 language tag.
`charset`	string	IANA character set label. Default `utf-8`.
`dir`	enum	`ltr` or `rtl`.
`authors`	array[author]	Must have at least one.
`document`	object	The screenplay container — see below.

Optional

Field	Type	Description
`generator`	object	Tool that produced the file: `{ name, version, meta? }`.
`locale`	string	BCP 47 locale — e.g. `en-US`. Default `en-US`.
`contributors`	array	See Authors & contributors.
`characters`	array[character]	Character index.
`colors`	array[color]	Reusable named colours.
`sources`	array	Source works this screenplay is based on: `{ id, type, title, meta? }`.
`registrations`	array	WGA / guild / national registry records.
`revisions`	array[revision]	Document-level revision history.
`encrypt`	object \| null	Default encryption parameters.
`license`	object \| null	`{ id, ref?, meta? }`.
`taggable`	slug[]	Master index of every tag slug used in the document. Helper; optional.
`genre`	slug[]	Genre tags.
`themes`	slug[]	Thematic tags.
`logline`	text	One-sentence summary.
`analysis`	object	See Analysis.

`document` container

Field	Type	Description
`cover`	object	Cover page metadata. Required.
`layout`	object	Optional rendering rules. See Layout.
`bookmarks`	array	Stable shortcuts into scenes.
`scenes`	array[scene]	One or more scenes. Required.
`meta`	meta	Extension.

`cover`

Field	Type	Description
`title`	name	Required.
`authors`	uuid[]	Author ids shown on cover. Required.
`sources`	uuid[]	Source ids shown on cover.
`extra`	text	Free text.
`meta`	meta	Extension.

`bookmarks`

Stable shortcuts into scenes:

Field	Type
`id`	uuid
`scene`	uuid
`element`	uuid
`title`	text
`desc`	text
`meta`	meta

All fields except desc and meta are required.

Overview Shared types