Otomasyon8 dk okuma

n8n'de Sub-workflow Nedir, Nasıl Kurulur?

n8n'de sub-workflow kurulumu; Execute Sub-workflow Trigger ve Execute Sub-workflow node'ları, veri aktarımı ve var olan node'ları sub-workflow'a çevirme.

Miraç Kuru · Yayın 28 Ekim 2026

n8n'de Sub-workflow Nedir, Nasıl Kurulur?
Bu yazıda· 7 bölüm
  1. 1.n8n'de sub-workflow ne işe yarar?
  2. 2.Ana workflow ile sub-workflow arasında veri nasıl taşınır?
  3. 3.Sub-workflow nasıl kurulur?
  4. 4.Sub-workflow ana workflow'dan nasıl çağrılır?
  5. 5.Var olan node'lar sub-workflow'a nasıl çevrilir?
  6. 6.n8n sub-workflow'da sık görülen sorunlar nasıl çözülür?
  7. 7.Sonraki adım

Kısa cevap

n8n'de sub-workflow, başka bir workflow'un içinden çağrılıp çalıştırılan workflow'dur. Büyük bir workflow'u parçalara bölmek ve aynı adımları birden çok workflow'da kullanmak için kurulur. Sub-workflow, Execute Sub-workflow Trigger node'uyla başlar. Ana workflow onu Execute Sub-workflow node'uyla çağırır ve sub-workflow'un son node'unun sonucunu geri alır. Belgelere göre sub-workflow execution'ları planın execution sınırına dâhil edilmez.

  1. 1

    Sub-workflow'u başlat

    Yeni bir workflow aç, "Add first step" düğmesine tıkla ve Execute Sub-workflow Trigger node'unu seç.

  2. 2

    Girdileri tanımla

    Input data mode alanında Define using fields below, Define using JSON example ya da Accept all data seçeneğini seç.

  3. 3

    Sub-workflow'u kaydet

    Sub-workflow'un işini yapan node'ları ekle, hataları düzelt ve workflow'u kaydet.

  4. 4

    Ana workflow'dan çağır

    Ana workflow'a Execute Sub-workflow node'unu ekle, Source alanında Database ve From list seç ve sub-workflow'u listeden bul.

  5. 5

    Girdileri doldur ve çalıştır

    Workflow Inputs bölümündeki girdileri doldur ve workflow'u çalıştır. View sub-execution bağlantısıyla sub-workflow'un execution'ını aç.

n8n'de sub-workflow, başka bir workflow'un içinden çağrılıp çalıştırılan workflow'dur. Sub-workflow'u çağıran workflow'a ana workflow denir. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. 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. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır. Temel n8n kavramları n8n nedir yazısında anlatılır.

n8n'de sub-workflow ne işe yarar?

Belgelere göre sub-workflow'lar iki iş için kullanılır:

  • Büyük bir workflow daha küçük parçalara bölünür. Belgelere göre bu bölme, bellek sorunlarına yol açacak kadar büyüyen workflow'larda da yardımcı olur.
  • Aynı adımlar tek bir workflow'da toplanır ve birden çok workflow bu adımları çağırarak kullanır.

Tekrar eden adımlar tek bir sub-workflow'da toplandığında bu adımlardaki bir düzeltme sadece sub-workflow'da yapılır.

Örnek: Bir kişi, müşteri taleplerini işleyen uzun workflow'undaki sınıflandırma adımlarını ayrı bir sub-workflow'a taşır. Ana workflow kısalır ve her parça ayrı ayrı düzenlenir.

Örnek: Bir içerik ekibi, farklı kaynaklardan video fikri toplayan workflow'larının hepsinde aynı rapor sub-workflow'unu çağırır. Ekip rapor biçimini değiştirmek istediğinde sadece bu sub-workflow'u düzenler.

Execution, bir workflow'un bir kez çalışmasının kaydıdır. Belgelere göre ücretli n8n planlarında aylık bir execution sınırı bulunur. Yayımlanmış workflow, Publish düğmesiyle canlıya alınmış workflow'dur. Sub-workflow'ların execution'ları bu sınıra ve planın yayımlanmış (aktif) workflow sınırına dâhil edilmez. Sınıra sadece zinciri başlatan ana workflow'un execution'ı dâhil edilir.

Ana workflow ile sub-workflow arasında veri nasıl taşınır?

Execute Sub-workflow node'u, ana workflow'un içinden başka bir workflow'u çalıştıran node'dur. Execute Sub-workflow Trigger node'u ise bir workflow'u başka bir workflow'dan gelen çağrıyla başlatan trigger node'dur. Belgelere göre bu trigger node, sub-workflow'un ilk node'u olmalıdır.

Belgelerdeki örnekte Workflow A'daki Execute Sub-workflow node'u, Workflow B'yi çağırır. Veri şu sırayla taşınır:

  1. Workflow A'daki Execute Sub-workflow node'u, veriyi Workflow B'nin Execute Sub-workflow Trigger node'una iletir.
  2. Workflow B'nin son node'u, sonucu Workflow A'daki Execute Sub-workflow node'una geri gönderir.

AI Agent, bir dil modeliyle karar verip araç kullanan n8n node'udur. Belgelere göre Execute Sub-workflow Trigger node'u, bir workflow'u AI Agent'ın aracı yapan Call n8n Workflow Tool node'undan gelen çağrıyla da çalışır. AI Agent kurulumu n8n'de yapay zekâ ajanı nasıl kurulur yazısında anlatılır.

Örnek: Bir ana workflow, formdan gelen müşteri adını ve e-posta adresini sub-workflow'a gönderir. Sub-workflow bir karşılama metni hazırlar ve son node'u metni ana workflow'a geri gönderir. Ana workflow metni e-postayla iletir.

Sub-workflow nasıl kurulur?

Girdi, ana workflow'un sub-workflow'a gönderdiği veridir. Sub-workflow, Execute Sub-workflow Trigger node'uyla başlayan ayrı bir workflow olarak şu adımlarla kurulur:

  1. n8n'de yeni bir workflow oluştur. Boş bir workflow açılır.
  2. "Add first step" düğmesine tıkla. n8n, trigger node'ları arayıp seçebildiğin node panelini (nodes panel) açar.
  3. Node panelinde Execute Sub-workflow Trigger node'unu ara ve seç. Belgelere göre bu node, trigger node'lar arasında When Executed by Another Workflow adıyla da görünür. Node canvas'a eklenir.
  4. Node'un ayarlarında Input data mode alanından girdilerin nasıl tanımlanacağını seç.
  5. Trigger node'un sağındaki "Add node" (+) düğmesine tıkla. Açılan node panelinden sub-workflow'un işini yapacak node'ları ekle.
  6. Sub-workflow'u kaydet.

Veri türü, bir değerin metin, sayı ya da başka bir biçimde olduğunu gösterir. JSON, veriyi ad ve değer çiftleriyle yazan bir metin biçimidir.

Input data modeNe yapar
Define using fields belowAna workflow'un göndermesi gereken her girdinin adı ve veri türü tek tek tanımlanır. Çağıran node bu alanları kendiliğinden getirir.
Define using JSON exampleBeklenen girdileri ve türlerini gösteren örnek bir JSON nesnesi yazılır.
Accept all dataGelen bütün veri kabul edilir ve zorunlu girdi tanımlanmaz. Eksik ya da tutarsız veri, sub-workflow'un kendi node'larında ele alınır.

Örnek: Bir kişi, Execute Sub-workflow Trigger node'unda Define using fields below seçeneğiyle müşteri adı ve e-posta adresi için birer girdi tanımlar. Bu girdiler, sub-workflow'u çağıran node'da kendiliğinden görünür.

Sub-workflow ana workflow'dan nasıl çağrılır?

Ana workflow'a Execute Sub-workflow node'u şu adımlarla eklenir:

  1. Sub-workflow'u çağıracak workflow'u aç.
  2. Bir node'un sağındaki "Add node" (+) düğmesine tıkla. Bütün node'ların listelendiği node paneli açılır.
  3. Node panelinde Execute Sub-workflow node'unu ara ve seç. Node canvas'a eklenir.
  4. Node'un Source alanında sub-workflow'un nereden alınacağını seç.
  5. Workflow Inputs bölümünde sub-workflow'un istediği girdileri doldur.
  6. Workflow'u kaydet. Ana workflow çalıştığında Execute Sub-workflow node'u veriyi sub-workflow'a gönderir ve sub-workflow'u çalıştırır.
SourceDoldurulan alanWorkflow'u nereden alır
DatabaseFrom list ya da Workflow IDn8n'in veritabanından, listeden seçerek ya da ID ile
Local FileWorkflow PathYerelde kayıtlı bir JSON dosyasından
ParameterWorkflow JSONNode'a yazılan JSON kodundan
URLWorkflow URLBir web adresinden

Workflow ID, workflow'un adresinde /workflow/ bölümünden sonra gelen harf ve rakam dizisidir. Belgelerdeki örnekte adres https://my-n8n-acct.app.n8n.cloud/workflow/abCDE1f6gHiJKL7 ise Workflow ID abCDE1f6gHiJKL7 olur.

Belgelere göre Database ve From list seçildiğinde sub-workflow'un girdileri Workflow Inputs bölümünde kendiliğinden listelenir ve her girdiye bir değer yazılır ya da eşlenir. Workflow Inputs bölümünden bir girdi kaldırılırsa sub-workflow o girdi için boş değer (null) alır. Attempt to convert types seçeneği açıldığında n8n, veriyi sub-workflow'un istediği türe çevirmeyi dener.

Item, node'lar arasında taşınan verideki tek bir kayıttır. Node'un Mode alanında iki seçenek bulunur:

  • Run once with all items seçeneğinde node, gelen bütün item'larla bir kez çalışır.
  • Run once for each item seçeneğinde node, gelen her item için sırayla bir kez çalışır.

Örnek: Bir kişi, gelen her müşteri kaydı için karşılama metni sub-workflow'unun ayrı ayrı çalışmasını ister ve Run once for each item seçeneğini seçer. Bütün kayıtları tek seferde işleyen bir rapor sub-workflow'u için ise Run once with all items seçeneğini seçer.

Node'da ayrıca Wait for Sub-Workflow Completion seçeneği bulunur. Seçenek açıksa ana workflow sub-workflow'un bitmesini bekler, kapalıysa beklemeden devam eder.

Sub-workflow henüz yoksa Source alanında Database ve From list seçilir ve listedeki Create a sub-workflow seçeneğiyle yeni bir sub-workflow oluşturulur.

Ana workflow çalıştıktan sonra Execute Sub-workflow node'undaki View sub-execution bağlantısı, sub-workflow'un execution'ını açar. Sub-workflow'un execution'ında da ana workflow'un execution'ına dönen bir bağlantı bulunur.

Örnek: Bir kişi, müşteri kaydı yapan ana workflow'una Execute Sub-workflow node'unu ekler ve listeden karşılama metni sub-workflow'unu seçer. Workflow Inputs bölümündeki müşteri adı ve e-posta girdilerine önceki node'ların değerlerini eşler.

Var olan node'lar sub-workflow'a nasıl çevrilir?

Belgelere göre n8n 1.97.0 sürümünden itibaren bir workflow'daki node'lar doğrudan sub-workflow'a çevrilebilir. Expression, bir parametrenin değerini önceki node'ların verisinden dolduran yazımdır. Belgelere göre başka node'lara başvuran expression'lar çevirme sırasında kendiliğinden güncellenir. Bu expression'lar, yeni sub-workflow'un Execute Sub-workflow Trigger node'una girdi olarak eklenir.

Node'lar şu adımlarla sub-workflow'a çevrilir:

  1. Canvas'ta sub-workflow'a taşımak istediğin node'ları seç.
  2. Canvas'ın boş bir yerine sağ tıkla. Bir menü açılır.
  3. Menüde Convert to sub-workflow seçeneğini seç. n8n, seçili node'ları yeni bir sub-workflow'a taşır.

Tek bir node'u çevirmek için fareyi canvas'taki node'un üzerine getir. Node üzerinde beliren düğmelerden Node context menu simgesine tıkla ve Convert node to sub-workflow seçeneğini seç.

Belgelere göre seçim kesintisiz olmalı ve şu koşulları taşımalıdır:

  • Seçimde trigger node olmamalıdır.
  • Seçimin dışından bağlantı alan tek bir node olmalıdır. Bu node'a birden çok bağlantı gelebilir, ama node'un tek bir giriş dalı olmalı ve seçimdeki diğer node'lardan bağlantı almamalıdır. Merge node'u, birden çok giriş dalından gelen veriyi tek akışta birleştiren node'dur. Belgelere göre bu yüzden seçimin girişindeki node bir Merge node'u olamaz.
  • Seçimin dışına bağlantı veren de tek bir node olmalıdır. Bu node'dan birden çok bağlantı çıkabilir ama node'un tek bir çıkış dalı olmalıdır. Node, seçimdeki diğer node'lara bağlantı vermemelidir. Belgelere göre bu node örneğin bir If node'u olamaz. If node'unun true ve false adlı iki çıkış dalı vardır.
  • Giriş ve çıkış node'ları arasındaki bütün node'lar seçimde yer almalıdır.

Örnek: Bir kişi, sipariş workflow'undaki faturayı hazırlayan node'ları seçer ve Convert to sub-workflow seçeneğiyle ayrı bir sub-workflow'a taşır. Kişi bu sub-workflow'u başka workflow'lardan da çağırır.

n8n sub-workflow'da sık görülen sorunlar nasıl çözülür?

Edit Fields (Set) node'u, verideki alanları ekleyen, değiştiren ya da kaldıran node'dur. Sub-node, AI Agent gibi bir node'a bağlanıp onun işlevini genişleten node'dur. Sık görülen durumlar ve çözümleri şunlardır:

  • Bir workflow sub-workflow'u çağıramıyorsa sub-workflow'un üç nokta simgeli Options menüsünden Settings seçeneğini aç. Workflow settings penceresindeki This workflow can be called by ayarına bak. Belgelere göre bu ayar, sub-workflow'u hangi workflow'ların çağırabileceğini belirler.
  • Execute Sub-workflow node'unda girdiler listelenmiyorsa sub-workflow'un Input data mode alanına bak. Belgelere göre trigger node Accept all data modundaysa girdiler görünmez.
  • Çevrilen sub-workflow'da girdi ve çıktı türlerini elle seç. Belgelere göre girdi ve çıktılar varsayılan olarak her türü kabul eder. Türler, Execute Sub-workflow Trigger node'unda ve Return adlı Edit Fields (Set) node'unda seçilir.
  • AI node'larını çevirirken AI araçları gibi bütün sub-node'ları seçime ekle. Belgelere göre başka AI Agent'larla ortak kullanılan node'ların çevirmeden önce çoğaltılması gerekebilir.
  • Çevrilen sub-workflow'da node'ların çalışma sırasını kontrol et. Belgelere göre yeni sub-workflow, ana workflow'un ayarından bağımsız olarak node'ların çalışma sırasını belirleyen Execution order ayarında v1 (recommended) seçeneğini kullanır. Bu sıralama sub-workflow'un ayarlarından değiştirilebilir.
  • Expression'larda first(), last(), all() ya da itemMatching işlevi varsa çevirmeden sonra bu expression'ları kontrol et. Belgelere göre itemMatching işlevinde sıra numarası (index) sabit bir sayı olmalıdır.

Örnek: Bir kişi, bir AI Agent'a bağlı araçları sub-workflow'a çevirirken ajanın bütün araç sub-node'larını seçer. Çevirmeden sonra Execute Sub-workflow Trigger node'unda girdi türlerini elle seçer.

Sonraki adım

n8n'de yeni bir workflow aç ve "Add first step" düğmesiyle Execute Sub-workflow Trigger node'unu ekle. Define using fields below seçeneğiyle tek bir girdi tanımla ve sub-workflow'u kaydet. Ardından içinde bir trigger node bulunan başka bir workflow'a Execute Sub-workflow node'unu ekle. Böyle bir workflow yoksa yeni bir workflow aç ve "Add first step" düğmesiyle bir trigger node ekle. Execute Sub-workflow node'unda az önce kaydettiğin sub-workflow'u Database ve From list seçenekleriyle bul. Girdiyi doldur, "Execute workflow" düğmesine tıkla ve View sub-execution bağlantısıyla sub-workflow'un execution'ını aç.

Kurduğun bu sub-workflow, tekrar eden adımları tek bir yerde toplayan kalıcı bir sistemin ilk adımıdır.

Sık sorulanlar

Sub-workflow execution'ları plan sınırına dâhil edilir mi?

Belgelere göre sub-workflow'ların execution'ları aylık execution sınırına dâhil edilmez. Bir workflow başka bir workflow'u Execute Sub-workflow node'uyla çağırdığında sadece ana workflow'un execution'ı sayılır. Sub-workflow'lar yayımlanmış (aktif) workflow sınırına da dâhil edilmez.

Execute Sub-workflow node'unda girdiler neden görünmüyor?

Belgelere göre girdiler, sub-workflow Source alanında Database ve From list seçenekleriyle seçildiğinde listelenir. Sub-workflow'un Execute Sub-workflow Trigger node'u Accept all data modundaysa girdiler görünmez.

Var olan node'lar sub-workflow'a nasıl çevrilir?

Node'lar canvas'ta seçilir, canvas'ın boş bir yerine sağ tıklanır ve Convert to sub-workflow seçilir. Belgelere göre bu özellik n8n 1.97.0 sürümünden itibaren bulunur. Seçimde trigger node olmamalıdır.

Ana workflow sub-workflow'un bitmesini bekler mi?

Ana workflow'un sub-workflow'un bitmesini bekleyip beklemeyeceğini Execute Sub-workflow node'undaki Wait for Sub-Workflow Completion seçeneği belirler. Seçenek açıksa ana workflow bekler, kapalıysa beklemeden devam eder.

Sub-workflow'u hangi workflow'ların çağırabileceği nasıl seçilir?

Sub-workflow'da Options menüsünden Settings seçilir ve Workflow settings penceresi açılır. Belgelere göre bu penceredeki This workflow can be called by ayarı, sub-workflow'u çağırabilecek workflow'ları belirler.

Kaynaklar

  1. 1.n8n Docs, Break workflows into smaller partsErişim: 12 Ekim 2026
  2. 2.n8n Docs, Sub-workflow conversionErişim: 12 Ekim 2026
  3. 3.n8n Docs, Execute Sub-workflowErişim: 12 Ekim 2026
  4. 4.n8n Docs, Execute Sub-workflow Trigger nodeErişim: 12 Ekim 2026
  5. 5.n8n Docs, Work with nodesErişim: 12 Ekim 2026
  6. 6.n8n Docs, Understand executionsErişim: 12 Ekim 2026

İlgili yazılar

Otomasyon kategorisine dön