glx add citation

Create a citation entity

Synopsis

Create a Citation entity in the archive.

--source is required and must reference an existing source. --external-id is repeatable in the form type:value (e.g. familysearch:ark:/61903/1:1:C4H8-2DW2).

glx add citation [flags]

Examples

  # Citation with URL and external ID
  # --external-id is parsed as TYPE:VALUE on the FIRST colon, so the
  # type cannot itself contain colons. Use a short identifier scheme name
  # (familysearch, wikidata, geonames, ...) as the type.
  glx add citation --source source-fs-births-deutschland \
    --url "https://www.familysearch.org/ark:/61903/1:1:C4H8-2DW2" \
    --accessed 2026-04-20 \
    --external-id "familysearch:ark:/61903/1:1:C4H8-2DW2" \
    --archive ./archive

  # Citation with a locator (page or entry number) and transcription
  glx add citation --source source-1860-census \
    --locator "p. 47, dwelling 312" \
    --text-from-source "John Webb, 35, farmer …" \
    --archive ./archive

Options

      --accessed string           Date the source was accessed (YYYY-MM-DD)
  -a, --archive string            Archive path (directory) (default ".")
      --dry-run                   Print what would be created without writing files
      --external-id stringArray   External ID in the form type:value (repeatable)
      --force                     Overwrite an existing entity with the chosen ID
  -h, --help                      help for citation
      --id string                 Override the derived entity ID
      --locator string            Locator (page number, entry, etc.)
      --note stringArray          Free-text note (repeatable)
      --repository string         Repository ID (optional override)
      --skip-validate             Skip whole-archive validation after adding (vocab and reference checks still run)
      --source string             Source ID (required)
      --source-date string        Date carried by the source itself
      --text-from-source string   Verbatim transcription from the source
      --url string                Canonical URL

Options inherited from parent commands

  -q, --quiet   Suppress non-error output (where supported)

SEE ALSO

• glx add - Create entities (person, place, event, …) from CLI flags