Dear TEI Community,

the TEI Consortium has released version 3.3.0 of the TEI Guidelines (Codename: Johnny Rotten). Our release technicians today were Hugh Cayless and myself, assisted by Peter Stadler and James Cummings. The release was mostly uneventful, which is the way we like it. For details, please see the release notes below.

As always, we encourage you all to report bugs and make feature requests via the GitHub site at Your input is what tells us what to work on, and we cannot do without it! All of the TEI Consortium's software projects are hosted at and issues or feature requests should be reported at the various project repositories there. The Guidelines are available from all the usual places (such as the TEI website and the GitHub site A new release of the TEI Stylesheets has been made in conjunction with the 3.3.0 release at See more details for the Debian package at

Best wishes and happy encoding!
Martina Scholger

Release 3.3.0 (code name: Johnny Rotten<>) of the TEI Guidelines introduces new features and resolves a number of issues raised by the TEI community. As always, the majority of these changes and corrections are a consequence of feature requests or bugs reported by the TEI community using the GitHub tracking system. A full list of the issues resolved in the course of this release cycle may be found under the 3.3.0 milestone<>.

Highlights of this release include:

  *   A new attribute class att.linguistic<> has been introduced. The existing attributes lemma and lemmaRef are now members of the new attribute class, the attributes pos, msd and join were newly introduced. The elements <w><> and <pc><> are members of att.linguistic<> (#1670<>).
  *   The <form><> element is now a member of att.typed<> (#1688<>).
  *   The <gb><> element is now a member of att.edition<> (#1677<>).
  *   The element <etym><> is now a member of att.typed<> and permits recursive <etym><> elements (#1512<>).
  *   The elements <c><>, <cl><>, <hyph><>, <m><>, <orth><>, <phr><>, <quote><>, <s><>, <seg><>, <stress><>, <syll><> and <w><> are now members of att.notated<>, and thus now can have the notation attribute (#1510<>, #1514<>, #1734<>).
  *   <remarks><> is now permitted as a child of <valItem><> if <desc><> is also a child (#1420<>).
  *   <bibl><> is now permitted in <witDetail><> (#1425<>).
  *   The content model of <affiliation><> in the jTEI schema has been expanded and allows <placeName><> now (#1692<>).
  *   A number of content models have been improved, including:
     *   the <listRef><> element (#1674<>)
     *   the <content><> element (#1719<>, #1716<>)
     *   the <choice><> element (#1690<>)
  *   The explanations and discussions of several features have been improved:
     *   the inconsistent definition of the reason attribute for <gap><> and <unclear><> has been unified (#1729<>)
     *   the description of the <content><> element has been clarified (#1718<>), as well as the prose discussing its use for writing content models (#1459<>)
     *   the description of the <move><> element has been clarified (#1705<>)
  *   A new Exemplar called tei_customization has been added. It supports writing a TEI customization by hand (#1349<>).
  *   The appendices A to E now mention the number of distinct items included in them (#1517<>).
  *   The macro macro.anyXML is now deprecated (#1585<>), as <anyElement><> is available.

Dozens of wording improvements and corrections of typographic errors have been made to the Guidelines.

In addition, many improvements have been made to the XSLT stylesheets (which provide processing of TEI ODD files for Roma<> and OxGarage<> as well as other TEI conversions). The Stylesheets are maintained separately from the Guidelines and are at

Martina Scholger
Centre for Information Modelling - Austrian Centre for Digital Humanities
Elisabethstraße 59/III
8010 Graz