JSON Sort

Related

What is JSON Sort?

Use Cases

• Unify key order in team JSON config files, package.json, tsconfig.json, etc. to reduce Git Diff noise
• Sort two JSONs before comparing to eliminate false differences from different key orders, letting diff focus on real changes
• Standardize API response data key order to ease front-end caching, IndexedDB storage, and object hash computation
• Persist CI/CD config center, Feature Flag service configs in canonical key order, for easier audit and rollback
• Tidy large JSON config files or data exports — sorting keys alphabetically makes them visually cleaner
• Unify key order before writing JSON to database / Redis / message queue, to guarantee idempotent downstream consumption

How to Use

1. Paste the JSON content to be sorted into the left input box, or click "Sample" to load a typical multi-level JSON, or upload a .json/.txt file
2. Select sort mode from the bottom options bar: default "Sort by key"; switch to "Sort by array" if you need to sort array elements
3. Toggle the ascending / descending button as needed, check or uncheck "Recursive" (on by default)
4. Click the "Sort" button; the right output box shows the formatted sorted result. Click "Copy" or "Download" to save as sorted.json

Features

• Two sort modes: supports "Sort by object key" and "Sort by array element" core modes, switchable with one click
• Recursive nested processing: recursion on by default, descending into multi-level nested objects to sort keys at every level, ensuring structure is consistently tidy
• Ascending/Descending toggle: built-in ascending (A-Z) / descending (Z-A) toggle button, flexible for reading habits and business requirements
• localeCompare dictionary order: key comparison uses local dictionary order, correctly sorting Chinese, special characters, and emoji
• Preserves data structure: only adjusts key name and array element order, does not add or remove fields, does not modify value types
• Sample data quick experience: built-in "zoo + alpha/beta/omega" demo data, one-click load to see the sort effect
• Local processing for privacy: parsing, sorting, and formatting all happen locally in the browser, no input sent to any server
• Seamless downstream handoff: sorted results can be one-click copied to JSON Formatter, Diff Compare, Schema Validator, etc. for further processing

Code Examples

// Recursive key sort, returns a new object (does not modify original)
function sortKeysDeep(value) {
  if (Array.isArray(value)) return value.map(sortKeysDeep);
  if (value !== null && typeof value === 'object') {
    return Object.keys(value)
      .sort((a, b) => a.localeCompare(b))
      .reduce((acc, k) => {
        acc[k] = sortKeysDeep(value[k]);
        return acc;
      }, {});
  }
  return value;
}

const data = { zoo: { animals: ['zebra', 'elephant'] }, alpha: 1, beta: 2 };
const sorted = sortKeysDeep(data);
console.log(JSON.stringify(sorted, null, 2));
// => {
//      "alpha": 1,
//      "beta": 2,
//      "zoo": { "animals": ["zebra", "elephant"] }
//    }

import json

data = {"zoo": {"animals": ["zebra", "elephant"]}, "alpha": 1, "beta": 2}

# Auto-sort by alpha when serializing with sort_keys
sorted_json = json.dumps(data, indent=2, sort_keys=True, ensure_ascii=False)
print(sorted_json)

# Array sort by value
arr = [3, 1, 4, 1, 5, 9, 2, 6]
print(sorted(arr))          # numeric ascending
print(sorted(arr, reverse=True))  # descending

# String dictionary order
print(sorted(['banana', 'Apple', 'cherry']))  # ['Apple', 'banana', 'cherry']

# Recursive key sort + 2-space indent
jq -S '.' data.json

# Explanation: -S (--sort-keys) sorts all object keys recursively in ASCII ascending order

# Sort array by element string lexicographic order (objects compare by their JSON string)
jq 'sort' data.json

# Sort array by some field (e.g. by age ascending)
jq 'sort_by(.age)' data.json

# Descending
jq 'sort_by(.age) | reverse' data.json

FAQ

Troubleshooting

Glossary

JSON Sort

Reordering JSON object keys alphabetically or array elements by value; does not change any field value or type, only physical order.

localeCompare

JavaScript built-in string lexicographic comparison function returning -1/0/1. This tool uses localeCompare to sort keys, correctly handling Chinese, special characters, and emoji.

ASCII Ascending / Descending

Sort by character Unicode code points (ASCII table); uppercase A-Z comes before lowercase a-z, digits 0-9 come before letters.

locale-aware Sort

Sort that respects language conventions; for Chinese it defaults to Unicode code point or browser locale, which differs from strict Pinyin sort.

Integer-like Key

An object key that looks like a non-negative integer (e.g. "0", "1", "2"); JavaScript engines auto-iterate them in numeric ascending order. Spec behavior, cannot be turned off.

Recursive Sort

Sorting key names at every level of nested objects. This tool enables it by default; disabling it only sorts the top level.

Canonical Form

Normalized form; JSON sort is one way to construct a canonical form, easing diff, cache hashing, and cross-environment consistency.

Git Diff Noise

Diff lines in code review produced by formatting differences (not real logic changes); commits with differently-ordered JSON keys generate large amounts of noise diff.

pre-commit Hook

Script that runs automatically before a Git commit; many teams invoke `jq -S .` in pre-commit to sort JSON file keys before add, ensuring consistent JSON order in the repo.

JSON Diff Tool

A tool (e.g. jsondiffpatch) that compares two JSONs to find differences; recommended to sort both sides first, to eliminate false diff from key order.

JSON Sort Scenarios & Method Reference

JSON Sort vs JSON Diff vs JSON Merge

Authoritative References

• MDNArray.prototype.sort - MDN Web Docs
• jqjq manual - sort / sort_by
• PythonPython json.dumps sort_keys parameter
• IETFJSON Specification (RFC 8259)