You have downloaded a .json file - an API response, an app export, a data backup - and nothing on your phone will show it in a readable way. This guide covers why, and what to do about it.

Short version: install a dedicated JSON viewer, open the app, and pick your file from the file picker. That handles most cases where tapping the file directly does nothing. The details, and what to do when it still won't open, are below.

What is a JSON file?

JSON stands for JavaScript Object Notation. It is a plain-text format used to store structured data.

JSON is common because it is simple, compact, and easy for apps, websites, and APIs to exchange. You might see it in API responses, settings exports, analytics files, app backups, saved user data, or developer tools.

A small file might look like this:

{
  "user": {
    "name": "Alex",
    "active": true,
    "roles": ["admin", "editor"]
  }
}

The curly braces hold objects, square brackets hold lists, and values can be text, numbers, true/false values, null, objects, or lists. That structure is useful, but it can be hard to read when everything is compressed onto one long line or nested many levels deep.

Why won't a JSON file open properly on Android?

Android does not always include a dedicated viewer. When you tap a file, Android asks installed apps whether they can open that type. JSON is usually labeled as application/json or text/json, but some file managers, email apps, and cloud apps do not pass that information clearly.

That is why a file may open as raw text, show as a download with no preview, appear as one unreadable line, or fail to open at all.

Common reasons include:

Your file manager only has a basic text preview.
The file came from email, chat, browser downloads, or cloud storage without a clear file type.
The JSON is minified, meaning all spacing and line breaks were removed.
The file is very large, so a simple viewer or editor struggles to load it.
The file is not valid JSON, even if the filename ends with .json.

A proper viewer formats the data, shows the structure, and lets you move through nested objects and arrays without editing the file by accident.

How to open a JSON file on Android, step by step

1. Install a JSON viewer

Install JSON Viewer from Google Play. It is free and needs no account.

2. Open the app and tap Open JSON File

Launch the app. The home screen has an Open JSON File button, with any files you have opened before shown in a grid with their size and date.

3. Pick the file

The system file picker opens. Choose the .json file from your device storage, your Downloads folder, or another app such as mail or cloud storage. Because it uses Android's built-in document picker, you can open files from normal storage locations without moving them into a special folder.

4. Read the formatted data

The file is pretty printed automatically and opens in a structured tree view. Expand and collapse nodes to move through it, search inside the content to find a value, and bookmark anything you need to come back to.

Long-press a node for more detail - the node view helps you inspect keys, values, paths, and nested content more directly than a plain text editor.

Tips and troubleshooting

If tapping the file does not open it correctly

Open the app first, then tap Open JSON File and choose the file from the picker. This avoids many file-manager handoff problems. You can also share a file into the app from another app, if Android recognizes it as JSON.

If the file appears as one huge line

That usually means the JSON is minified. Minified JSON is normal for APIs and exports because it saves space, but it is unpleasant to read by hand. A dedicated viewer pretty prints it automatically, adding indentation and structure so objects, arrays, keys, and values are easier to scan.

If the file is too large

The free version is intended for smaller files. The default free limit is about 2 MB, though the exact limit may vary. Very large file support is available in Pro.

For large files, avoid opening them in a general note app or simple text editor first. A structured viewer is better suited for expanding only the parts you need and keeping navigation manageable.

If the file will not open

The file may be empty, incomplete, corrupted, or not valid JSON. It may also have been moved, deleted, or shared without permission for the app to read it.

Try these checks:

Make sure the file really ends in .json.
Re-download or re-export the file from the original app or website.
Open it through the Android file picker instead of a shortcut.
If it is stored in cloud storage, make sure it is fully downloaded or available offline.
If you copied the text instead of saving a file, use the app's paste option.

If you need to find a value quickly

Use search to look for a key, value, or piece of text inside the file. For more precise queries, Pro adds JSONPath search, useful when you know the path or pattern you are looking for. Bookmarks help with large or deeply nested files - mark important nodes and return to them without scrolling through the whole document again.

If your JSON is not stored as a file

The home screen also supports other input methods:

Paste from the clipboard.
Load from a URL.
Scan a QR code that contains JSON or a link to it.

These help when the content starts in a browser, API tool, QR code, email, or another app instead of as a saved file in Downloads.

The app behind this guide

JSON Viewer is my own Android app, and it is what the steps above describe. It pretty prints and formats the file automatically, lays it out in a clean tree view you can expand and collapse, searches inside the content, holds up with large files, and has a dark mode. The core viewer is free and needs no account.

An optional Pro unlock adds very large file support, JSONPath search, copying node paths, saved bookmarks, and saving, sharing, or exporting the formatted result.

How to Open a JSON File on Android (Step by Step)