JSON Merge — Deep Merge Two JSON Documents Online
Combine a base JSON document with an overlay using deep or shallow merge. The result updates automatically, and a live conflict preview lets you control arrays, null handling, and conflict resolution.
Developer notes
Both documents must be valid JSON. Automatic merge — the result updates when both inputs are valid (debounced) and when you change options; no Merge button. B wins is the default conflict strategy: overlay values override base scalars. Error on conflict blocks output and lists conflicting JSON paths. Union by key merges arrays of objects like a database upsert on `id`. Ignore nulls skips null values from the overlay — useful for sparse patches. This is not RFC 7386 Merge Patch — the tool outputs a merged document, not a patch file. After merging, use JSON diff to verify against your expected baseline.
JSON merge options
- Merge depth
- Deep merges nested objects key by key; shallow replaces entire nested objects and arrays from the overlay.
- Array strategy
- Replace (default), concatenate, concatenate unique values, or union arrays of objects by a key field.
- Union key
- Field used to upsert objects when the array strategy is union by key, similar to a database merge on `id`.
- Conflict resolution
- Overlay wins (default), base wins, or error on conflict to block output and list conflicting paths.
- Null handling
- Ignore null overlay values (default), merge nulls, or delete keys when overlay sets null.
- Indent size
- Spaces per indentation level in the formatted merged output.
- Indent style
- Spaces or tabs for output formatting.
When teams pick this route
Merge environment config (base + staging overlay). Combine package.json overrides. Stitch partial API responses. Apply feature-flag deltas to a defaults file.
Worked examples
Deep merge config
Base (A)
Overlay (B)
Port becomes 8080; both feature keys remain after a deep merge with overlay winning on conflicts.
Array concat
Base (A)
Overlay (B)
Tags become `["alpha","beta","gamma"]` with array strategy set to concat.
Navigate related JSON tools
Compare merged output in JSON diff. Normalize key order first with JSON sort. Validate with the JSON validator, fix syntax with JSON repair, or browse the JSON tools hub.
JSON merge FAQ
Merge vs diff, arrays, and nulls
Do I need to click Merge?
No. The merged JSON updates automatically when both documents are valid and whenever you change merge options.
How is JSON merge different from JSON diff?
JSON diff highlights differences between two documents. JSON merge produces a single combined document using your depth, array, and conflict rules.
Which document wins on conflicts?
By default, the overlay (document B) wins on scalar conflicts. You can switch to base wins or error on conflict.
What is shallow vs deep merge?
Deep merge combines nested objects key by key. Shallow merge replaces entire nested objects and arrays from the overlay.
How are arrays handled?
Choose replace (default), concat, concat unique, or union by key for arrays of objects.
What happens when the overlay contains null?
With ignore nulls (default), nulls in the overlay are skipped. With merge nulls, they are written as null. With delete on null, the key is removed from the result.
Do you support three-way merge?
No. This tool merges exactly two JSON documents (base and overlay).
Is this JSON Merge Patch (RFC 7386)?
No. The output is a merged JSON document, not an RFC 7386 patch operations file.
JSON Tools
Validate, format, repair, compare and explore JSON in your browser, alongside the JSON minifier and converters.
Explore other tool categories
- Minify
Minify JavaScript, CSS, HTML, JSON, XML, SVG and other formats to cut the bytes you ship, before gzip or a CDN.
- Unminify
Make minified code readable again to debug or review it. Unminify JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML and other formats.
- Conversion
Convert data between JSON, YAML, XML, CSV, TOML and other formats locally, with no upload to a server.
- Encoding
Encode or decode Base64, URLs, HTML entities and JWTs, and generate hashes and HMACs in your browser.
- Serialization
Serialize and deserialize PHP data structures beside JSON workflows.
- SVG Tools
Preview, optimize with SVGO, export as a data URI, resize, beautify, convert to JSX and validate SVG in your browser.
- Beautify
Make code readable with consistent indentation. Beautify JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML and more in your browser.
- CSS preprocessors
Compile SCSS or LESS to standard CSS in your browser. Pair it with beautify or minify to handle a whole stylesheet.
- Color & CSS Tools
Check WCAG contrast, convert CSS colors and units, and generate shades, border-radius and box-shadow code in your browser.
- DevOps & Infra
Terraform HCL format/validate/minify, Dockerfile format & lint, Docker Compose and .env validation.
- CI/CD
Format GitHub Actions and GitLab CI YAML and check the structure of workflows and jobs in your browser.
- Logs & observability
Format, filter and validate JSON and NDJSON logs, and turn Nginx or Apache access logs into CSV or TSV.
- Kubernetes
Multi-doc manifests, structural validate, Ingress/Deployment starters, and Helm values formatting.
- Networking / IP
Subnet calculator, IP converter, range to CIDR, CIDR summarize and IP-in-subnet checks for IPv4 and IPv6, in your browser.
- Security & tokens
Inspect JWKS, verify JWTs, decode X.509 certificates, convert PEM and JWK, scan text for secrets and hash with bcrypt in your browser.
- API & schemas
Format, validate, lint and convert OpenAPI, JSON Schema and GraphQL SDL in your browser.
- HTTP Tools
Paste cURL commands, HTTP messages, URLs, HAR files and Cookie or Set-Cookie headers to format and inspect them. Nothing is sent.
- SEO / Web Tools
Generate meta tags, Open Graph, Twitter Card, robots.txt, sitemap.xml and JSON-LD in your browser. Previews come from your input, and your site is never fetched.
- Developer utilities
Timestamps, UUID, ULID, Nanoid, cron, passwords, regex, slugs, number bases, letter case, text diff, chmod and Lorem Ipsum, all in your browser.
- Text & Markdown
Count words, build Markdown tables of contents, turn CSV into Markdown tables and sort or deduplicate lines in your browser.
- AI & LLM
Count tokens, estimate API costs, check context-window fit, convert JSON to TOON and analyze prompts, all in your browser.
- Test Data
Dummy names, emails, phone numbers, addresses, dates, IBANs, card numbers and JSON, CSV or SQL rows for fixtures and database seeds. Everything is generated in your browser.
- Barcode labels
Draw Code 128, EAN-13 and UPC-A labels and static QR codes in your browser, then download PNG or SVG. This is not a GS1 lookup.