The ninjs generator tool has been updated to the new ninjs 1.3

At last week’s Spring Meeting IPTC updated the News in JSON standard (ninjs) to version 1.3. The JSON schema of the new version can be accessed at https://www.iptc.org/std/ninjs/.

The updated schema now has support for trust indicators, genre, other types of headlines and a way for providers to enter their own alternative IDs.

Version 1.3 is backwards-compatible with previous versions of ninjs and makes no breaking changes.

It includes the following new properties and structures:

  • genre follows the structure of other objects in ninjs with the possibility to add a code, a name and a reference to a scheme of the code to indicate the genre of the news item.
  • trustindicator is also an object with properties to indicate and point at documents describing the providers status according to defined trust indicators. Read more about trust indicators here.
  • There has been a demand for other types of headlines, such as “subhead” or “mobile headline”. The original headline property is still in the schema. But in version 1.3 it is now accompanied by a headline_ construct which works in the same manner as body_ and description_. Providers can now add other types of headlines and name them to indicate format and/or type.
  • altid is a property that is open to the provider’s own definition of both names and types of sub-properties. That way providers can include alternative IDs as they originally appeared.
  • The 1.3 schema also includes a $standard object which contains properties for name, version and reference to the schema that the item follows. This is not (yet) supported in software tools but the idea is that tools could look up the schema for which a document is written, similarly to the way that XML allows users to state the XML Schema that should validate a document.

The user guide, sample generator and GraphQL sample have all been updated according to the 1.3 additions.

ninjs 1.3 will soon be included in the SchemaStore.org JSON Schema repository, to aid with editing and validation of ninjs 1.3 files in a range of popular code editors such as Visual Studio Code and Visual Studio 2013+, IntelliJ IDEA, PyCharm and PHPStorm.

For more information, please see:

If you have any questions or comments, please contact the News in JSON Working Group via the public ninjs discussion group, or contact IPTC via the Contact Us form.