JSONGRID

The JSONGrid field guide

From your first JSON file to your daily workspace. Practical guides for editing, organizing and sharing your data on web and desktop.

LEARN BY DOING

A little JSON. A lot to explore.

Live renderer

Sort a column, expand a nested field, or double-click a value. The source updates with your edits. This sample stays in memory and resets when you leave.

Enable JavaScript to try the interactive sample. All guides below remain readable without it.

01

Getting started

Open your first documentStart with a file, your clipboard, or an empty document.

Web app · Desktop app

  1. Choose Open JSON file, paste JSON, or drop a .json file into the workspace. You can open multiple files.
  2. Use Grid to explore, Source to edit text, or Split to see both.
  3. Expand objects and arrays to inspect nested values. Local exploration does not require an account.

Clipboard access may require browser permission; a paste dialog is available if it fails. Standard JSON is supported, not JSON5 or JavaScript object literals.

Link to this guide ↗
Grid, Source & SplitMove between structure and source without losing your place.

Web app · Desktop app

Source uses Monaco for syntax coloring, folding, completion, search and diagnostics. If editor assets cannot load, a plain-text editor remains available. Split keeps the grid and source together; drag the divider to adjust their space.

Invalid source is retained while the grid shows the last valid JSON. Correct the source before editing grid cells. Grid and source edits share undo/redo history.

Link to this guide ↗
JSON-ConnectSee exactly where a cell, row or column lives in the source.

Web app · Desktop app

In Split view, select a value, row heading or column name to highlight its corresponding JSON source. A column can highlight multiple ranges. The adjacent arrow sorts independently.

Selections follow original JSON paths even after sorting or filtering. Reverse selection from source to grid and whole-table selection are not implemented.

Link to this guide ↗
02

Explore & edit

Objects, arrays & nested tablesFollow the structure without flattening your document.

Web app · Desktop app

Objects display property/value rows. Arrays of objects become tables using every discovered key, including keys outside the current page. Mixed arrays use indexed rows. Expand individual collections, or use Expand all and Collapse all.

A missing property displays an em dash; an explicit null displays null. Arrays inside record cells start collapsed.

Link to this guide ↗
Edit valuesDouble-click a primitive cell, or press Enter or F2.

Web app · Desktop app

Strings accept plain text without JSON quotes; typing 123 into a string keeps it a string. Numbers, booleans and null use JSON primitive syntax. Press Enter to commit, Escape to cancel, or Shift+Enter for a newline in a string. Leaving a field commits valid input.

Invalid input stays in the editor with validation feedback. Use Source to change the document structure. The app retains up to 50 undo edits in memory; undo history resets on reload.

Link to this guide ↗
Find, sort & filterFocus on useful records while preserving the original JSON.

Web app · Desktop app

Find in JSON searches keys and values. Column filters narrow a table; filters on multiple columns combine. Text filters include contains, equals, not equals, starts with and ends with. Numeric fields offer comparisons such as greater than; boolean fields offer True and False. Use a column’s sort control to cycle ascending, descending and original order.

Sorting and filtering affect the view, not the stored array order or document contents. They operate across the collection, not only the visible page.

Link to this guide ↗
Row actions & deletionInspect a full record or remove a row or property.

Web app · Desktop app

Open a row’s options to inspect it in full or delete it when editing is enabled. Property deletion can also remove nested contents; non-empty object properties ask for confirmation.

Deletion changes the JSON, unlike hiding a column. The deletion feedback offers Undo. In the application, edits also participate in document undo history. Use Source for broader structural changes such as adding new fields.

Link to this guide ↗
Make a table your ownResize, reorder, choose and flatten columns.

Web app · Desktop app

Drag a header edge to resize a column and drag a column header to reorder it. Use the column picker to choose visible fields. Flatten nested columns brings nested object fields into the table without changing the JSON.

Reset table view clears filters, sorting, flattening and column preferences while keeping your JSON edits. Column widths and order are scoped to each table.

Link to this guide ↗
Pages & all-records viewerBrowse large collections with bounded rendering.

Web app · Desktop app

Tables use numbered pages, with 25 rows by default. Settings → Grid lets app users choose 1–100 rows per page. Show all records opens a read-only, virtualized viewer; close it or press Escape to return to your page.

Search, filters, sorting and column selection use the full dataset. Virtualization limits rendered rows, but parsing, searching and sorting are still synchronous. Million-row performance is not certified; columns are not virtualized.

Link to this guide ↗
Read long valuesCompact previews with the complete value a click away.

Web app · Desktop app

Long primitive values have a single-line preview, with newlines and tabs shown as ↵ and ⇥. Hover to preview a clipped value or open its accessible full-value dialog. Editing is available when enabled.

The default preview is 50 Unicode characters. The app’s Grid settings can change the limit; choose a length that suits your documents. Previewing never truncates the stored data.

Link to this guide ↗
Format, minify, copy & exportTake your JSON or a table into the next step of your workflow.

Web app · Desktop app

In the app, use Format JSON for readable indentation, Minify JSON for compact text, and Copy JSON for the clipboard. Browser JSON downloads need no account. Desktop builds with native file support use a Save As dialog without requiring sign-in.

The shared grid’s CSV export includes visible columns. Flatten nested objects first to include their fields; remaining objects and arrays export as blank cells. Formatting requires valid JSON and uses JavaScript number semantics: retain precision-sensitive identifiers as strings.

Link to this guide ↗
Compare JSONInspect structural differences between two documents.

Web app · Desktop app

Open Compare JSON from the rail and choose the left and right inputs. Inspect changed values, additions and removals using the comparison views.

Comparison ignores object-key order; array positions remain significant. Comparison selections are separate from local draft recovery, so retain the inputs you need before restarting or updating.

Link to this guide ↗
03

Workspace & cloud

Tabs, folders & pinned filesKeep related work close at hand.

Web app · Desktop app

Drag tabs to reorder them. A tab’s three-dot menu, right-click or Shift+F10 offers pinning, moving and close actions, including close others and close to the right.

The sidebar separates pinned files, saved cloud files and unsaved local drafts. Create folders, rename files or use Move to folder; drag files onto folder headers to move them. Pinning, moving a draft to a cloud folder, and sharing prompt you to save with a verified account. Free includes up to three folders; Pro adds unlimited folders with two-level nesting.

Link to this guide ↗
Local recovery & unsaved workUnderstand what survives a reload.

Web app · Desktop app

Local drafts are recovered through IndexedDB. Cloud documents and pending cloud edits are not durable local drafts: explicitly save changes before signing out or reloading. Browser storage can be cleared, so recovery is not a substitute for keeping your own files.

Undo history and document grid view state are kept in memory. Browser and desktop recovery use separate profiles. A persistence error is reported rather than treated as a successful save.

Link to this guide ↗
Save & organize cloud filesSave deliberately, then reopen from your account sidebar.

Web app · Desktop app

Sign in and verify your account, then choose Save, a filename and an optional folder. Save is manual. Reopen saved files from the sidebar; further edits remain unsaved until you save again.

Cloud saving uses last-write-wins behavior, without live collaboration or conflict merging. Deleting a cloud file is permanent and revokes its share links. Deleting a folder moves its files to the root if names do not conflict.

Link to this guide ↗
Share links & manage accessShare the latest saved content, with optional restrictions.

Web app · Desktop app

Choose Share. Create a public link, or enable email restrictions to create recipient-specific links. Optionally choose an expiry date. Email links sends individual recipient links; Create share link lets you copy them yourself.

Recipients view the latest saved JSON read-only; a signed-in recipient can save an editable copy. Restricted links require the matching signed-in account. Use Unshare to revoke links, remove all access or adjust expiry. A selected expiry date includes that local day. Sharing a selection only is not supported.

Link to this guide ↗
File activityReview metadata about file and sharing actions.

Web app · Desktop app

Open File activity from the sidebar or a saved-document menu to inspect recorded actions. The read-only log includes file and share operations and distinguishes client-reported failures.

Activity expires after 90 days and contains metadata, not previous JSON contents. It is not Trash, version history or a restore mechanism.

Link to this guide ↗
Account, plans & supportManage your identity and application subscription.

Web app · Desktop app

Open your profile to sign in using an email code or an available Google/GitHub provider. Profile controls include display name and optional authenticator-app two-factor authentication.

Usage and billing provides Personal Pro upgrades and subscription management. See current site pricing for plan details. Use Contact support in the app or the support page for help.

Link to this guide ↗
Appearance & workspace settingsAdjust the space to the way you read.

Web app · Desktop app

Settings offers light/dark appearance, syntax themes, dense grid spacing, rows per page, cell preview length and interface zoom from 75% to 150%. Preferences apply immediately and are stored locally.

Drag the sidebar edge to resize it; double-click to restore its default width. Collapse it for more document space. Settings → About shows build information and lets web users check for a newer build.

Link to this guide ↗
04

Desktop app

On Disk, Ctrl+S & Save AsChoose between saving the original file and making a cloud copy.

Desktop app

In desktop builds with native file support, files opened through the OS, native picker or native drag-and-drop appear under On Disk. Reopening a file focuses its existing tab and preserves unsaved edits.

Ctrl+S saves an On Disk document to its original path, including invalid JSON text. External file changes, missing files and write failures are reported without clearing unsaved edits. The toolbar Save flow creates a separate cloud copy; Download opens a native Save As dialog without requiring sign-in.

Closing a tab does not delete the disk file. Older recovered documents without a path must be reopened once. These features require a desktop package containing native file support; source availability alone does not confirm Store rollout.

Link to this guide ↗
Windows files & desktop workspaceUse the same editor with operating-system integration.

Desktop app

The desktop shell shares the web workspace’s grid, source, comparison and account features. Installed Windows packages register JSONGrid as an option for .json files. Choose it through Open with or Windows Default apps; installation does not silently change your default.

Files launched from Windows wait for recovery and active dialogs or edits before opening. Invalid JSON opens in Source for correction. File integration depends on the installed package; newer capabilities in this documentation may require an update.

Link to this guide ↗
Tray, window & quitKeep your session open between visits.

Desktop app

Keep JSONGrid running when I close the window is enabled by default. Closing hides the window; click the tray icon or choose Open JSONGrid to return. Launching another instance restores the existing window.

Choose Quit JSONGrid to exit fully, or turn off close-to-tray. Quit waits for recovery writes. If recovery fails, you can cancel quitting or explicitly discard changes since the last recovery copy. No launch-at-login behavior is installed.

Link to this guide ↗
Sign in through your browserReturn to your desktop session after authentication.

Desktop app

Google and GitHub sign-in open your default browser, then return through the registered JSONGrid desktop link. Allow the browser to open JSONGrid when prompted.

If the return does not work, confirm you are using an installed, up-to-date package and retry. Provider availability also depends on service configuration. Existing documents are preserved through the sign-in flow.

Link to this guide ↗
Microsoft Store updatesCheck for an update and protect work before installing.

Desktop app

Store-installed Windows builds check automatically and offer Check Microsoft Store for updates in Settings → About. Normal updates show Update now / Later; updates are non-blocking by default.

A separately designated required update can prevent continued editing. Export work and Check again remain available. Updating waits for local recovery and requires a backup of unsaved cloud/comparison work when necessary. Cancelled or failed backup stops installation. Store availability and rollout determine what can actually install.

Link to this guide ↗

KEEP YOUR HANDS ON THE KEYS

Small shortcuts. Faster work.

Open JSON filesCtrl / ⌘ + O
Edit a focused cellEnter or F2
Commit / cancel cell editEnter / Escape
Newline in a stringShift + Enter
Document or tab menuShift + F10
Move focused tab or columnAlt + Shift + ← / →
Resize a focused column grip← / → (Shift for larger steps)
Close all-records viewerEscape