Choose a merge tool by data shape
Merge Tools combine multiple sources into a result while exposing rules that depend on the source format. Start with the structure you need to preserve: rows in a table, values in JSON, elements in XML, or configuration mappings and sequences in YAML.
- Dataset Merger & Joiner is for CSV, TSV, spreadsheet, pasted-table, JSON-array, and JSONL datasets. Use append/union to stack rows, or keyed join to match two datasets by one or more columns.
- JSON Merge Tool is for two or more JSON object or array documents. Choose shallow or recursive deep merging, precedence, null handling, and global or per-path array behavior.
- XML Merge Tool is for two XML documents treated as namespace-aware trees. It checks root compatibility and supports append, replace, or key-based child-element strategies.
- YAML Merge Tool is for layered YAML documents or multi-document streams, such as a base configuration and an override. It includes document pairing and policies for sequences, anchors, aliases, merge keys, and comments.
Decide whether you need row matching or document merging
Use the Dataset Merger & Joiner when records from two tables must be matched by keys, such as combining rows that share an identifier. Its join mode offers inner, left, right, and full joins, while append/union mode places datasets one after another and maps their columns into a shared shape.
Use one of the format-specific document tools when the input is a structured document rather than a table of records. JSON, XML, and YAML each have different nesting, ordering, namespace, sequence, or configuration concerns, so their merge pages expose different policies instead of treating every source as rows.
Review rules before exporting
- Load the sources into the tool that matches their format and confirm the source order when precedence or output order matters.
- Choose the merge strategy and conflict rules. For datasets, decide between stacking rows and matching keys. For JSON or YAML, decide between shallow and deep behavior and how sequences are handled. For XML, choose how child elements are identified and merged.
- Inspect the preview and the reported conflicts, unmatched items, unsupported constructs, or other format-specific review data before exporting the result.
These tools are for combining sources, not for every related data task. If you need to compare versions without producing a combined document, use a dedicated comparison tool instead. If you need a format change instead, choose a converter from the data converter tools.
Format-specific limitations to keep in mind
Each merger documents its own input and preservation rules. The dataset tool expects structured tabular or array-style records and does not preserve spreadsheet layout, formulas, or formatting. The XML tool requires compatible roots before merging. The YAML tool re-serializes structure, so comments are not preserved, and strict policies or incompatible multi-document pairing can block a run. Check the selected tool's review and limitation guidance when the source contains constructs that must be preserved exactly.