itemMatching() Usage Example for Data Linking in n8n

This n8n workflow serves as a practical tutorial on the itemMatching(itemIndex: Number) function within a Code node. It starts with a Manual Trigger, fetches a list of customers from the 'Customer Datastore (n8n training)' node, then uses an 'Edit Fields' node to reduce the data to just names, simulating a filtering step. Finally, a Python Code node iterates over the filtered items, employing itemMatching(i) to reference the original customer data by index and append the 'restoreEmail' field with the matching email.

The key benefit is enabling precise data cross-referencing in multi-branch or filtered workflows where direct JSON access fails due to mismatched item counts. This prevents data loss during transformations, saving time on complex automations. Sticky notes provide clear guidance on generating and reducing data.

Ideal use cases include data enrichment pipelines, such as matching user lists to profiles, restoring metadata after aggregations, or linking subsets in CRM/ERP integrations. Developers and n8n users can adapt this for custom matching logic in production workflows, enhancing reliability without external tools.