Terms

An object for grouping titles, alternate titles and other bilingual terms reused across Sefaria.

Terms

A Term is a shared title node which is used to group titles, alternate titles and titles in other languages (i.e. Hebrew).

Some objects, such as Index records store their own various titles. But for other system objects that is not currently a possibility.

To this end, we use the Term object to add titles to items that need them, such as categories, sharedTitles on Categories, and section names.

Here's a sample Term for the section name for chapters:

{
  "scheme" : "section_names",
  "titles" : [
    {
      "lang" : "en",
      "text" : "Chapters",
      "primary" : true
    },
    {
      "lang" : "he",
      "text" : "פרקים",
      "primary" : true
    }
  ],
  "name" : "Chapters"
}

And here's a Term for the table of contents sub-category of Geonim:

{
  "name" : "Geonim",
  "titles" : [
    {
      "text" : "Geonim",
      "lang" : "en",
      "primary" : true
    },
    {
      "text" : "גאונים",
      "lang" : "he",
      "primary" : true
    }
  ],
  "scheme" : "toc_categories"
}