# Merge lists — List merger

Botize method — `btzmerge.merge` (action).

Combine two lists by matching items using a field from each list.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `input_1` *(string)* — Input 1 (list)
- `input_2` *(string)* — Input 2 (list)
- `mode` *(string, one of: "append" = Append; "combine" = Combine, default: "append")* — Input 2 (list)
- `field_1` *(string)* — Field in Input 1
- `field_2` *(string)* — Field in Input 2
- `output_type` *(string, one of: "keep_matches" = Only matched itemsMerge items that match. This is like an inner join.; "enrich_input_1" = Keep all from Input 1Keep all data from Input 1, and add matching data from Input 2. This is like a left join.; "enrich_input_2" = Keep all from Input 2Keep all data from Input 2, and add matching data from Input 1. This is like a right join.; "keep_everything" = Keep everythingMerge items together that do match and include items that don't match. This is like an outer join.; "keep_non_matches" = Only non-matching itemsMerge items that don't match., default: "keep_matches")* — Output

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{merged_list}}` *(array)* — Merged list. The resulting list after combining Input 1 and Input 2.

## This app

Every trigger and action for List merger: https://botize.com/en/app/btzmerge.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/btzmerge/merge