Otomasyon8 dk okuma

n8n Merge Node Nedir, Nasıl Kullanılır?

n8n Merge node'uyla dalların verisini birleştirme; Append, Combine, SQL Query ve Choose Branch modları, eşleştirme seçenekleri ve sık görülen sorunlar.

Miraç Kuru · Yayın 30 Ekim 2026

n8n Merge Node Nedir, Nasıl Kullanılır?
Bu yazıda· 8 bölüm
  1. 1.n8n Merge node'u ne işe yarar?
  2. 2.Merge node'u workflow'a nasıl eklenir?
  3. 3.Merge node'unda hangi modlar var?
  4. 4.Combine modunda veriler nasıl eşleşir?
  5. 5.Combine modunda hangi seçenekler var?
  6. 6.Execution order ayarı Merge node'unu nasıl etkiler?
  7. 7.n8n Merge node'unda sık görülen sorunlar nasıl çözülür?
  8. 8.Sonraki adım

Kısa cevap

n8n Merge node'u, farklı node'lardan ya da workflow'un ayrı dallarından gelen veriyi tek bir veri setinde birleştirir. Append modu girişlerin item'larını art arda sıralar. Combine modu iki girişin item'larını alan değerine, sıraya ya da bütün olası birleşimlere göre birleştirir. SQL Query modu veriyi bir sorguyla birleştirir. Choose Branch modu iki dalı bekler ve birinin verisini değiştirmeden aktarır.

  1. 1

    Node'u ekle

    Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla, arama kutusuna Merge yaz ve Merge node'unu seç.

  2. 2

    Girişleri bağla

    Birinci dalın son node'unu Input 1 girişine, ikinci dalın son node'unu Input 2 girişine bağla.

  3. 3

    Modu seç

    Merge node'unu aç ve Mode ayarında Append, Combine, SQL Query ya da Choose Branch seçeneğini seç.

  4. 4

    Eşleştirmeyi ayarla

    Combine modunda Combine By ayarını seç. Matching Fields için Input 1 Field ve Input 2 Field kutularına alan adlarını yaz.

  5. 5

    Dene

    Execute workflow düğmesiyle workflow'u bir kez çalıştır, Merge node'unda Execute step düğmesine tıkla ve sonucu çıktı bölümünde (OUTPUT) kontrol et.

n8n Merge node'u, farklı node'lardan ya da bir workflow'un ayrı dallarından gelen veriyi tek bir veri setinde birleştirir. Kullanmak için birleşecek iki dalın son node'ları Merge node'unun girişlerine bağlanır ve Mode ayarında birleştirme biçimi seçilir. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. Dal, workflow'un bir noktada ayrılmasıyla oluşan yollardan biridir. Veri her dalda kendi node'larından geçerek ilerler. Temel n8n kavramları n8n nedir yazısında anlatılır.

n8n Merge node'u ne işe yarar?

Belgelere göre workflow dallara ayrıldığında Merge node'u bu dalları yeniden tek bir dalda birleştirir. Item, bir node'dan ötekine taşınan verinin tek bir birimidir; bir tablodaki satıra benzer. Alan, bir item içindeki tek bir bilgidir ve bir ad ile bir değerden oluşur. Örneğin bir kişiyi anlatan item'da name alanının değeri kişinin adıdır. Giriş, Merge node'una bir daldan veri getiren bağlantıdır. Girişler Input 1, Input 2 diye numaralanır.

Merge node'u, workflow dallara ayrılmamış olsa bile önceki iki node'un verisini tek bir veri setinde birleştirebilir.

Veri tek bir sette toplanınca, tabloya yazan ya da e-posta gönderen adım bütün kaynaklar için bir kez kurulur.

Örnek: Bir YouTube kanalı sahibi, video listesini Google Sheets'teki bir tablodan, video notlarını Notion'dan okur. Merge node'u iki dalın verisini video adı alanına göre birleştirir. Sonraki node her videonun bilgisini ve notunu aynı satıra yazar.

Google Sheets'ten ve Notion'dan veri okuma n8n ile Google Sheets ve n8n ile Notion yazılarında anlatılır.

Merge node'u workflow'a nasıl eklenir?

Workflow'ların kurulup düzenlendiği ekrana n8n editörü denir. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır. Execute step, üzerinde bulunduğu node'u çalıştıran düğmedir. Node'un ayar penceresindeki çıktı bölümü (OUTPUT), node çalıştıktan sonra sonucun göründüğü yerdir. Merge node'u şu adımlarla eklenir:

  1. Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla. Node'ları arayıp seçebildiğin node paneli (nodes panel) açılır.
  2. Arama kutusuna "Merge" yaz ve çıkan Merge node'unu seç. Merge node'u canvas'a eklenir.
  3. Birinci dalın son node'unu Merge node'unun Input 1 girişine, ikinci dalın son node'unu Input 2 girişine bağla. İki dal canvas'ta Merge node'unda birleşir.
  4. Editörün altındaki Execute workflow düğmesine tıklayarak workflow'u bir kez çalıştır. Belgelere göre bu çalıştırma, girişlerdeki veriyi Merge node'una yükler.
  5. Merge node'unu aç ve Mode ayarında birleştirme biçimini seç.
  6. Merge node'unda Execute step düğmesine tıkla. Birleşen veri çıktı bölümünde görünür.

Merge node'unda hangi modlar var?

Belgelere göre Mode ayarında verinin nasıl birleşeceğini belirleyen dört seçenek bulunur:

ModeNe yaparNe zaman seçilir
AppendBütün girişlerin item'larını art arda sıralarAynı türden item'lar tek listede toplanacaksa
Combineİki girişin item'larını birleştirerek yeni item'lar oluştururİki kaynağın bilgisi aynı item'da görünecekse
SQL QueryVeriyi yazılan bir sorguyla birleştirirBirleştirme kuralı bir sorgu diliyle yazılacaksa
Choose BranchGirişlerden birinin verisini değiştirmeden verirİki dal bitince sadece birinin verisiyle devam edilecekse

Append

Append modunda giriş sayısı Number of Inputs ayarında seçilir. Node her girişin item'larını art arda verir ve bağlı bütün girişlerin çalışmasını bekler.

Örnek: Bir içerik ekibi video fikirlerini iki ayrı formdan toplar. Append modu iki formun yanıtlarını tek bir listede art arda sıralar. Sonraki node bu listeyi tek bir tabloya yazar.

SQL Query

SQL, tablolardaki veriyi sorgulamak için kullanılan bir dildir. SQL Query modunda önceki node'ların verisi tablo olarak kullanılır. Tablolar giriş sırasına göre input1, input2, input3 diye adlandırılır.

Node'un ayar penceresindeki Options bölümünde bulunan Query Parameters seçeneğiyle sorguya değer aktarılır. Bu değerleri n8n veri olarak işler; bu yöntem, değişken değerlerin sorgunun yapısını değiştirmesini engellemeye yöneliktir. Empty Query Result seçeneği, sorgu hatasız çalışıp hiç satır döndürmediğinde node'un ne vereceğini belirler. Varsayılan seçenek olan Empty Result hiç item vermez. Success seçeneği { "success": true } içeren tek bir item verir.

Örnek: Müşteri, sipariş ve ödeme verisi ayrı node'lardan gelir. SQL bilen bir kişi bu node'ları Merge node'unun girişlerine bağlar. Tek bir sorgu input1, input2 ve input3 tablolarını birleştirir.

Choose Branch

Choose Branch modu, iki girişin verisi de hazır olana kadar bekler. Output ayarında "Input 1 Data", "Input 2 Data" ve "A Single, Empty Item" seçenekleri bulunur. Node seçilen girişin verisini değiştirmeden verir.

Örnek: Bir workflow'un Input 1'e bağlı dalı videonun bilgisini tabloya yazar, Input 2'ye bağlı dalı ekibe bildirim gönderir. Output ayarında Input 1 Data seçilir. Merge node'u iki dalı bekler ve sonraki node'a sadece tablo dalının verisini verir.

Combine modunda veriler nasıl eşleşir?

Combine By ayarındaki üç seçenek, Combine modunda iki girişin item'larının nasıl eşleşeceğini belirler.

Matching Fields

Matching Fields, item'ları alan değerlerine göre karşılaştırır. Karşılaştırılacak alanların adları Fields to Match bölümünde Input 1 Field ve Input 2 Field kutularına yazılır. Belgelere göre n8n varsayılan olarak eşleşen item'ları tutar. Sonuç Output Type ayarıyla değiştirilir:

Output TypeSonuç
Keep MatchesEşleşen item'ları birleştirir (varsayılan)
Keep Non-MatchesEşleşmeyen item'ları verir
Keep EverythingEşleşen item'ları birleştirir, eşleşmeyenleri de ekler
Enrich Input 1Input 1'in bütün verisini tutar, Input 2'den eşleşen veriyi ekler
Enrich Input 2Input 2'nin bütün verisini tutar, Input 1'den eşleşen veriyi ekler

Örnek: Bir kişi müşteri listesini bir tablodan, siparişleri başka bir kaynaktan alır. Müşteri listesini veren node'u Input 1'e, siparişleri veren node'u Input 2'ye bağlar. Input 1 Field ve Input 2 Field kutularına e-posta alanlarının adlarını yazar ve Enrich Input 1'i seçer. Çıktıda bütün müşteriler kalır ve siparişi olan müşterilere sipariş bilgisi eklenir.

Position

Position, item'ları sıralarına göre birleştirir. Input 1'deki ilk item Input 2'deki ilk item'la, ikinci item ikinci item'la birleşir. Eşi olmayan item'lar varsayılan olarak çıktıya girmez.

Eşi olmayan item'ları da tutmak için Options bölümünde Add Option düğmesine tıkla. Açılan listede Include Any Unpaired Items seçeneğini seç ve ayarı aç.

Örnek: Video başlıkları bir node'dan, aynı sırayla hazırlanmış açıklamalar başka bir node'dan gelir. Position seçilince her başlık aynı sıradaki açıklamayla tek bir item'da birleşir.

All Possible Combinations

All Possible Combinations, iki girişteki item'ların bütün olası birleşimlerini verir ve aynı adlı alanları birleştirir.

Örnek: Bir mağaza sahibi All Possible Combinations seçeneğini kullanarak ürün listesini renk listesiyle birleştirir. Çıktıda her ürün her renkle ayrı bir item olarak yer alır.

Combine modunda hangi seçenekler var?

Combine modunda Options bölümünde şu seçenekler bulunur:

SeçenekNe yapar
Clash HandlingAynı adlı alanlar çakışınca hangi değerin kalacağını belirler
Fuzzy CompareAçıkken karşılaştırmada tür farkına bakılmaz. "3" metni ile 3 sayısı aynı kabul edilir. Varsayılan olarak kapalıdır
Include Any Unpaired ItemsPosition seçiliyken eşi olmayan item'ları da tutar. Varsayılan olarak kapalıdır
Disable Dot NotationBir alanın içindeki alt alanlara parent.child yazımıyla erişmeyi kapatır
Multiple MatchesBirden çok eşleşmede Include All Matches her eşleşme için bir item verir, Include First Match Only sadece ilk eşleşmeyi tutar

Belgelere göre birleşecek item'ların ikisinde de aynı adlı bir alan varsa çakışma (clash) oluşur. Input 2'de değer varsa varsayılan olarak o değer kullanılır. Clash Handling içindeki When Field Values Clash ayarında öncelikli giriş seçilir. Aynı ayardaki Always Add Input Number to Field Names seçeneği bütün değerleri tutar ve alan adının sonuna girişin numarasını ekler.

Merging Nested Fields ayarında Deep Merge, iç içe duran alanları her düzeyde birleştirir. Shallow Merge sadece en üst düzeydeki alanları birleştirir.

Örnek: İki kaynakta da durum adlı bir alan bulunur. Bir kişi Always Add Input Number to Field Names seçeneğini işaretler. Çıktıda iki değer de girişin numarasını taşıyan ayrı alanlarda görünür.

Execution order ayarı Merge node'unu nasıl etkiler?

Execution order, çok dallı bir workflow'da node'ların hangi sırayla çalışacağını belirleyen ayardır. Ayar, Workflow settings penceresindedir. Belgelere göre bu pencere, editörün sağ üst köşesindeki üç nokta simgeli Workflow menu'den Settings seçilince açılır. Ayarda iki seçenek vardır. Seçeneklerden v1 (recommended), dalları sırayla çalıştırır ve bir dal bitmeden ötekine geçmez. Öteki seçenek v0 (legacy), önce her dalın ilk node'unu, sonra ikinci node'unu çalıştırır. Varsayılan olarak n8n 1.0'dan önce kurulan workflow'lar v0 (legacy) sıralamasını kullanır.

If node'u, veriyi bir koşula göre true ve false adlı iki dala ayırır. If node'unun kurulumu n8n If node nedir yazısında anlatılır. If node'u normalde tek bir dalı çalıştırır. Eski v0 (legacy) sıralamada ise If node'unun iki dalı da aynı Merge node'una bağlıysa iki dal da çalışabilir. Bir dal Merge node'unu çalıştırır, Merge node'u da öbür dalı çalıştırır.

Örnek: Bir kanal sahibinin eski workflow'unda If node'unun true ve false dalları aynı Merge node'unda birleşir. Workflow eski v0 (legacy) sıralamayı kullandığı için iki dal da çalışabilir. Kanal sahibi Execution order ayarını v1 (recommended) yapınca bu davranış görülmez.

n8n Merge node'unda sık görülen sorunlar nasıl çözülür?

Merge node'uyla çalışırken karşılaşılan durumlar ve belgelerdeki çözümleri şunlardır:

  • Input 2'nin fazla item'ları çıktıda görünmüyorsa neden giriş önceliğidir. Belgelere göre girişlere farklı sayıda item gelirse Input 1'deki item'lar önceliklidir. Belgelerdeki örnekte Input 1'e beş, Input 2'ye on item gelir ve node sadece beş item işler. Position seçiliyken eşi olmayan item'ları tutmak için Include Any Unpaired Items seçeneğini aç.
  • Dalları aynı Merge node'unda birleşen bir If node'unun iki dalı da çalışıyorsa workflow v0 (legacy) sıralamayı kullanıyor demektir. Çözüm için Workflow settings penceresinde Execution order ayarını v1 (recommended) yap.
  • Merge node'unun, n8n'in sürümünden ayrı kendi sürüm numarası vardır. Empty Query Result seçeneği n8n 1.95.0 ile gelen 3.2 node sürümünde bulunur. Bundan önce eklenen Merge node'ları eski node sürümünde kalır ve sorgu satır döndürmediğinde her zaman { "success": true } verir. Çözüm için yeni bir Merge node'u ekle, sorguyu ve seçenekleri bu node'a kopyala.
  • Döngülü workflow'larda aynı node tek bir çalıştırmada birden çok kez devreye girer. Belgeler bu çalışmaların verisini birleştirmek için Code node'unu önerir. Döngü kurmanın adımları n8n'de döngü nasıl kurulur yazısında anlatılır.

Sonraki adım

n8n'de yeni bir workflow aç ve workflow'u başlatan ilk node'a, yani trigger node'a, farklı kaynaklardan veri okuyan iki node bağla. Bu iki node'u bir Merge node'unun Input 1 ve Input 2 girişlerine bağla ve Execute workflow düğmesiyle workflow'u bir kez çalıştır. Merge node'unun Mode ayarında Append'i seç ve Execute step düğmesine tıkla. İki kaynağın item'larının çıktı bölümünde art arda göründüğünü kontrol et.

Sık sorulanlar

n8n Merge node'u kaç girişi birleştirebilir?

Belgelere göre n8n 1.49.0 ve sonraki sürümlerde Merge node'u ikiden çok girişi destekler. Append modunda giriş sayısı Number of Inputs ayarında seçilir. Combine ve Choose Branch modları iki girişle çalışır. Eski sürümler en çok iki girişi destekler.

Merge node'unda eşleşmeyen item'lar neden çıktıda yok?

Belgelere göre Matching Fields varsayılan olarak sadece eşleşen item'ları tutar. Output Type ayarında Keep Everything seçilirse eşleşmeyen item'lar da çıktıda kalır. Enrich Input 1 ise Input 1'in bütün item'larını tutar. Position seçiliyse eşi olmayan item'ları tutmak için Options bölümünde Include Any Unpaired Items seçeneğini aç.

Merge node'unda aynı adlı alanlarda hangi değer kalır?

Belgelere göre Input 2'de değer varsa varsayılan olarak o değer kullanılır. Clash Handling seçeneğindeki When Field Values Clash ayarında öncelikli giriş seçilir. Always Add Input Number to Field Names seçeneği iki değeri de ayrı alanlarda tutar.

If node'uyla kullanılan Merge node'u neden iki dalı da çalıştırıyor?

Belgelere göre If node'unun iki dalının da çalışması sadece v0 (legacy) Execution order kullanan workflow'larda görülür. Varsayılan olarak n8n 1.0 sürümünden önce kurulan workflow'lar bu sıralamayı kullanır. Çözüm için Workflow settings penceresinde Execution order ayarını v1 (recommended) yap.

Kaynaklar

  1. 1.n8n Docs, Merge nodeErişim: 30 Ekim 2026
  2. 2.n8n Docs, Merging dataErişim: 30 Ekim 2026
  3. 3.n8n Docs, Work with nodesErişim: 30 Ekim 2026
  4. 4.n8n Docs, Configure workflow settingsErişim: 30 Ekim 2026
  5. 5.n8n Docs, Manual, partial, and production executionsErişim: 30 Ekim 2026

İlgili yazılar

Otomasyon kategorisine dön