How to Open a JSON File on Windows, Mac & Linux (2026 Guide)

Someone sends you a file called export.json. You double-click it. Windows shrugs and asks which app you want to use. Or Notepad opens and shows you a single line of text three thousand characters wide with no line breaks anywhere.

Nothing is broken. This trips up people who have been writing software for years, so if it caught you out, you are in good company.

Why double-clicking does nothing

A JSON file is just a text file. That is the whole story. The .json extension does not install anything, does not register an application, and does not carry any special formatting — it is a naming convention that tells humans and programs what kind of text to expect inside. The format itself is defined by RFC 8259, and it is short enough to read in one sitting.

On Windows, the operating system decides what to launch based on a registry association for the extension. Nothing claims .json by default, so you get the "How do you want to open this file?" dialog. On macOS the same thing happens more quietly — it usually falls back to TextEdit or Xcode.

The fastest way: paste it into a viewer

If you just need to read the thing once, do not install anything. Open the file in any text editor, select all, copy, and paste it into a browser-based viewer that formats and expands it for you.

JSON to Table Paste the contents and get a sortable table instead of a wall of braces. Everything runs in your browser — the file never leaves your machine, which matters if it contains customer data.

That last point is worth dwelling on. A lot of "JSON viewer" sites upload your file to a server to process it. If the export you were sent contains real user records, that is a data-handling decision you probably did not intend to make. Check before you paste.

Opening a JSON file on Windows

Right-click the file and choose Open with, then pick one of these rather than letting Windows guess:

Notepad — always present, but it will show minified JSON as one unreadable line. Fine for a quick look at small files.
VS Code — the practical answer. It understands JSON natively, and Shift+Alt+F reformats the file instantly.
Notepad++ — lighter than VS Code. Install the JSTool plugin and use Plugins → JSTool → JSFormat.
Your browser — drag the file onto a Chrome or Firefox window. Firefox in particular has a genuinely good built-in JSON viewer with collapsible nodes.

Opening a JSON file on macOS

The built-in option is TextEdit, but make it open in plain-text mode or it may try to be helpful in ways you do not want. From Terminal, these two cover almost everything:

Terminal

# Pretty-print any JSON file to the screen
cat subscribers.json | python3 -m json.tool

# Or with jq, which is worth installing (brew install jq)
jq . subscribers.json

If you would rather stay in a GUI, drag the file onto a browser window, or open it in VS Code. Quick Look (spacebar in Finder) will preview it as plain text too.

Opening a JSON file on Linux

Any editor works, but the command line is faster for anything large:

Terminal

# Pretty-print
jq . subscribers.json

# Page through a huge file without loading it all into an editor
jq . subscribers.json | less

# Just check whether it is valid, without printing it
jq empty subscribers.json && echo "valid"

What you are actually looking at

Once it is formatted, JSON is far less intimidating than it looks minified. Here is a small subscriber export — the same data, before and after.

subscribers.json — as you received it

[{"msisdn":"447700900142","imsi":"234150999912345","plan":"Unlimited 5G","roaming":true,"rsrp":-92},{"msisdn":"447700900458","imsi":"234150999967810","plan":"Pay As You Go","roaming":false,"rsrp":-104}]

subscribers.json — formatted

[
  {
    "msisdn": "447700900142",
    "imsi": "234150999912345",
    "plan": "Unlimited 5G",
    "roaming": true,
    "rsrp": -92
  },
  {
    "msisdn": "447700900458",
    "imsi": "234150999967810",
    "plan": "Pay As You Go",
    "roaming": false,
    "rsrp": -104
  }
]

Identical bytes to the parser. Only the whitespace changed. That is all "formatting" or "beautifying" JSON ever means — which is why it is safe to do it to a file you were sent.

[ ] is a list. This file holds two records.
{ } is one record with named fields.
Values in "quotes" are text. -92 is a number, true is a boolean, and neither takes quotes.

If you have also been handed XML and are wondering why the two look so different, this comparison covers what each format is actually for. MDN's JSON guide is the best next step if you want to start working with it in code.

JSON Formatter Paste the minified version and get the readable one back.

If it will not open at all

If your editor opens the file but a program rejects it, the file is almost certainly text with a syntax error. In order of how often I have seen them:

A trailing comma after the last item. Legal in JavaScript, illegal in JSON. This is the single most common cause.
Single quotes instead of double. {'a': 1} is not JSON. Only " counts.
Comments. JSON has no // or /* */ — the grammar simply has no production for them. If someone added notes, a parser will refuse the file.
A BOM at the start of the file, usually from Windows Notepad saving as "UTF-8 with BOM". Invisible in your editor, fatal to some strict parsers.
It is actually JSON Lines — one object per line with no wrapping [ ]. Common in log exports. Each line is valid on its own; the file as a whole is not.

JSON Validator Points at the exact line and character where parsing failed, which is usually enough to spot which of the five above you have hit.

The short version

A .json file is plain text. Nothing owns the extension, which is why double-clicking does nothing.
To read one once: paste it into a browser-based viewer.
To work with them regularly: install VS Code, or jq if you live in a terminal.
Never edit JSON in Word. Smart quotes will break it.
If a program rejects the file, check for a trailing comma first.