Skip to main content
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
iduuidStable across the document.
givenstring (1–50)Given name.
familystring (1–50)Family name.
metametaExtension — 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.