Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.screenjson.com/llms.txt

Use this file to discover all available pages before exploring further.

ScreenJSON separates two kinds of credit.

​
authors

Original writers. Required at the root (at least one) and at every element. 
{
  "id":     "<uuid>",
  "given":  "Jordan",
  "family": "Lee",
  "meta":   {}
}
FieldTypeRequiredNotes
iduuid✓Stable across the document.
givenstring (1–50)✓Given name.
familystring (1–50)✓Family name.
metameta—Extension — e.g. ORCID, WGA id.

​
contributors

Anyone who made artistic input other than original authorship — editor, director, script doctor, showrunner. Optional. 
{
  "id":     "<uuid>",
  "given":  "Ali",
  "family": "Okonkwo",
  "roles":  ["editor", "script-doctor"],
  "meta":   {}
}
Same fields as author, plus:
FieldTypeNotes
rolesslug[]Unique list of role slugs.

​
Element-level

Every element in a scene body carries:
  • authors: uuid[] — at least one author id from the root authors array.
  • contributors: uuid[] — any contributor ids from the root contributors.
Attribution at element granularity means revision history and editorial passes can be recorded without ambiguity.