How to Create a JSON File in Notepad (and Check It Is Valid)
Create a .json file in Notepad: write the JSON, check it, then Save as with All files and UTF-8. Includes the 5 syntax errors that break most hand-written JSON.
By Amit Yadav • November 15, 2026 • 5 min read
A JSON file is plain text with a .json extension. Config files for apps, VS Code settings, package files and API test data are all JSON. You can write one in Notepad in a minute. The hard part is not the saving. It is getting the syntax exactly right, because one stray comma makes the whole file unreadable to the program that loads it.
Step by step in Windows Notepad
- Open Notepad.
- Type or paste your JSON:
{
"name": "My App",
"version": 2,
"debug": false,
"tags": ["notes", "tools"]
}
- Press Ctrl + Shift + S (File, Save as).
- Set Save as type to All files (*.*).
- Name the file with
.jsonat the end, such asconfig.json. - Leave Encoding on UTF-8 and click Save.
Without step 4, Windows saves config.json.txt, and the app looking for config.json will not find it. Turn on File name extensions in File Explorer (View, Show) to see the real name.
Check the JSON before you save
Notepad does not warn you about mistakes. Paste the text into the JSON formatter first: it shows the line of the first error, and when the JSON is valid it formats it with clean indents. These five errors cause most failures:
| Mistake | Wrong | Right |
|---|---|---|
| Trailing comma | "b": 2,} | "b": 2} |
| Single quotes | {'a': 1} | {"a": 1} |
| Keys without quotes | {a: 1} | {"a": 1} |
| Comments | // note | Not allowed in JSON |
| Smart quotes | “a” | "a" |
Smart quotes sneak in when JSON is copied from Word, Outlook or a chat app. They look like normal quotes but are different characters.
UTF-8, not UTF-8 with BOM
Save JSON as plain UTF-8. RFC 8259, the JSON standard, says programs must not add a byte order mark, and common parsers such as Node.js JSON.parse and Python json.load fail with an “unexpected token” error on the first character when the BOM is there. Windows 11 Notepad uses UTF-8 without BOM by default, so leave it as is.
Make a JSON file on a Mac
Open TextEdit, choose Format, Make Plain Text, and paste the JSON. In TextEdit, Settings, Open and Save, turn off smart quotes first, or TextEdit may replace your straight quotes as you type. Save the file as config.json, and choose Use .json if asked.
Make a JSON file online
On a Chromebook or a locked down laptop:
- Paste your JSON into the JSON formatter to check and format it.
- Copy the result into the online notepad.
- Open Export, type
jsonunder Save as any file type, and click Save.
The file downloads with your note title as the name. Your text stays in your browser.
Related tools
- JSON formatter and validator: find errors, format or minify.
- Base64 decode and encode: for JSON that arrives Base64 encoded, such as a JWT payload.
- URL encoder: for JSON passed in a query string.
Tools to use with this guide
Keep this workflow practical with these related utilities.