Help Centre

How to use Jsonwell, and when to ask for help.

This tool is deliberately simple. If you run into something unexpected, these pages should get you unstuck.

Getting started

Jsonwell is a single-page tool. There is no account, no sign-up, and nothing to configure.

  1. Open the tool page.
  2. Paste your JSON into the textarea.
  3. Click Parse (or press the keyboard shortcut if enabled).
  4. If the JSON is invalid: read the exact line and column of the first error, the token the parser expected, and the offending character marked in context.
  5. If the JSON is valid: review the shape report — top-level key count, maximum nesting depth, the largest array, and any duplicate keys.

Frequently asked questions

Does Jsonwell upload my JSON to a server?

No. Everything runs in your browser using the built-in JSON.parse function. Your JSON — partial or complete — is never transmitted, stored, or logged by any server. See the privacy policy for full details.

Why does it say my JSON is valid when I know it has a problem?

Some configurations that look like mistakes are technically valid JSON. The most common case is duplicate keys{"a":1,"a":2} is legal JSON (the parser keeps the last value), and it is almost never what you meant. Jsonwell catches these in the shape report, labelled as duplicates.

Another case: trailing whitespace after the closing brace is valid. Jsonwell reports it, not as an error, but as a structural note.

Can I validate files, or do I have to paste?

Currently Jsonwell accepts paste-only input. There is no file-upload button or drag-and-drop zone. If your JSON is in a file, open it in a text editor, select all, copy, and paste into the tool.

How large a JSON document can I check?

The limit is whatever your browser can handle in a <textarea>. In practice this means documents up to a few megabytes are fine. Very large files (hundreds of megabytes) will cause the browser to slow or freeze, because everything is parsed synchronously in the main thread. There is no server-side parser that could handle larger payloads.

Does Jsonwell validate against a JSON Schema?

No. Jsonwell checks whether your input is valid JSON and reports structural properties of valid documents. It does not check whether the data conforms to a schema or a set of business rules. That is a different tool for a different job.

Is there an API, a CLI tool, or an IDE extension?

Not yet. Jsonwell is a browser-based tool only. There is no REST API, no command-line binary, and no editor plugin. If these are important to your workflow, let us know — contact details are below.

Known limitations

These are gaps we are aware of. None of them are bugs — they are design boundaries or features not yet built.

No file upload
Paste-only input. A drag-and-drop file reader is not implemented. Workaround: open the file in a text editor and copy the content.
No API or CLI
Jsonwell has no REST API, no command-line binary, and cannot be integrated into build pipelines or CI workflows. It is a browser page only.
No JSON Schema validation
The tool checks syntactic correctness and structural shape. It does not validate data types, required fields, or value ranges against a schema.
Single-document only
You can validate one JSON document at a time. There is no batch mode, no multi-tab interface, and no history of previous results.
No JSONPath or query support
Jsonwell locates errors. It does not navigate or query into valid JSON structures using JSONPath, jq-style expressions, or any other selector.
Browser memory constraint
Very large documents are limited by the browser's synchronous execution model and textarea capacity. There is no server-side fallback for oversized inputs.

Contact us

We are not yet reachable by email.

Jsonwell is an early-stage tool operated by a small team. A support email address and ticketing system have not been set up yet. This section will be updated when a contact route is available.

Until then: if you have found a genuine bug in the error-location output — where the tool marks the wrong character or reports incorrect line/column coordinates — open an issue on the project's issue tracker when one becomes available. For everything else, the FAQ above covers the most common questions, and the known limitations section documents what the tool intentionally does not do.