Json Schema file extension

Question

Is there any naming convention for a json schema file extension? XML has .xsd (XML Schema Definition), what should json schema files have, .jsd (JSON Schema Definition)?

As someone working on the JSON Schema specification currently, it's not really something that's been considered. If you think it should be, feel free to open an issue on the github repo. — Relequestual, Dec 22 '16 at 10:16

score 124 · Answer 1 · edited Dec 27 '17 at 23:20

124

From Gary Court:

I personally use .schema.json, but there is no official file extension. The official mime type however is "application/schema+json".

edited Dec 27 '17 at 23:20

chharvey

7,457
6
53
83

answered May 08 '12 at 22:43

Eric Hartford

14,576
4
32
47

12

I also use *.schema.json – jasonkarns Nov 13 '13 at 04:32
2

I also also also use *.schema.json – Daniel Santos Aug 16 '18 at 18:37

score 21 · Answer 2 · answered Jan 04 '14 at 17:17

According to the last draft (v4), there is not a new extension proposed for files storing json-schemas. .json extension is used profusely within that document. .json is also the preferred extension in validators (PHP, Ruby, Python).

So I think that .json should be the preferred option in absence of an official/standard new extension.

score 4 · Answer 3 · answered Jun 27 '20 at 19:36

From https://json-schema.org/understanding-json-schema/basics.html#id3

Since JSON Schema is itself JSON, it’s not always easy to tell when something is JSON Schema or just an arbitrary chunk of JSON. The $schema keyword is used to declare that something is JSON Schema. It’s generally good practice to include it, though it is not required.

So you can use .json as the file extension for JSON schema but maybe with a $schema keyword (although optional) for better distinction.

score 2 · Answer 4 · answered Oct 22 '15 at 15:39

2

I've started using .jschema after I had a run-in with an extension-based JSON Schema parser that automatically added id's to external RAML examples which are also .json files.

They are a specific format, after all. HTML is XML, which is UML, and we use a different file extension for each of those.

answered Oct 22 '15 at 15:39

Michał Tatarynowicz

1,254
2
14
31

11

No, HTML is not XML. There are [lots and lots](https://stackoverflow.com/a/39560454/1709587) of differences. – Mark Amery Nov 13 '18 at 13:49
3

Well, as of HTML5, HTML is a vocabulary defined for two related media types: text/html (which is a complicated parser not based on anything), and application/xhtml+xml (which is standard XML). – awwright Apr 30 '19 at 10:19
2

I think you mean SGML, not UML. – Daniel Schilling Jan 27 '20 at 16:56

score 0 · Answer 5 · answered May 01 '21 at 17:35

0

My suggestion is .jsd or .jsonsd standing for Json Schema Document.

I followed the way XML Schemas are named XSD (Xml Schema Document)

answered May 01 '21 at 17:35

Fabrice T

632
8
20

score 0 · Answer 6 · answered Mar 21 '22 at 17:30

A JSON Schema is a valid JSON file so the extension .json is OK.

Then, the first attribute of your file should be '$schema' to declare the version of the specification you are using. Eg.

    {
      "$schema": "https://json-schema.org/draft/2019-09/schema",

Json Schema file extension

6 Answers6