Robi Się SamoRSS

n8n Cheat Sheet

Ściąga n8n po polsku: nody, wyrażenia, webhooki, Code node, obsługa błędów, HTTP Request, AI Agent i dobre praktyki. Z wyszukiwarką, do pobrania jako .md.

8sekcji
181pozycji
n8n 2.48.6sprawdzone 19.11.2026

181 pozycji w 8 sekcjach. Kliknij wiersz z komendą, żeby ją skopiować.

Triggery

  • Manual TriggerRęczne uruchomienie workflow
  • Schedule TriggerHarmonogram: odstęp czasu albo wyrażenie cron
  • WebhookAdres HTTP, pod który inne systemy wysyłają dane
  • n8n Form TriggerFormularz WWW generowany przez n8n, który uruchamia workflow
  • Chat TriggerWiadomość z czatu n8n (hostowanego albo osadzonego na stronie)
  • Email Trigger (IMAP)Nowe maile w skrzynce
  • When Executed by Another WorkflowPoczątek sub-workflow (typ noda: Execute Workflow Trigger)
  • Error TriggerPoczątek workflow obsługującego błędy innych workflow

Logika

  • IfRozgałęzienie na dwie ścieżki: true i false
  • SwitchWiele ścieżek według reguł albo wartości
  • FilterZostaw tylko itemy spełniające warunek
  • MergeŁączenie danych: Append, Combine, SQL Query, Choose Branch
  • Loop Over ItemsPętla po itemach w paczkach po N sztuk (dawniej Split In Batches)
  • WaitPauza: odstęp czasu, konkretna data, wywołanie webhooka albo wysłanie formularza
  • Stop and ErrorCelowo zakończ workflow błędem (uruchamia Error Workflow)
  • No OperationNic nie robi – czytelne zakończenie gałęzi

Dane

  • Edit Fields (Set)Ustaw, zmapuj albo usuń pola
  • CodeWłasny kod: JavaScript albo Python
  • Split OutZamień listę w polu na osobne itemy
  • AggregateZbierz pole z wielu itemów w jedną listę (odwrotność Split Out)
  • SummarizeSuma, liczba, maksimum i grupowanie po polu – jak tabela przestawna
  • Remove DuplicatesUsuń powtórzenia – w jednym uruchomieniu albo względem poprzednich
  • SortSortowanie itemów
  • LimitOgranicz liczbę itemów
  • Date & TimeFormatowanie i obliczenia na datach
  • HTMLSzablon HTML, wyciąganie danych selektorami CSS, tabela HTML z itemów
  • XMLZamiana XML na JSON i odwrotnie
  • CryptoHash, HMAC, szyfrowanie i deszyfrowanie, podpis, losowe ciągi
  • Data TableWbudowana tabela n8n (Insert, Get, Update, Upsert, Delete) – bez zewnętrznej bazy

Połączenia i porządek

  • HTTP RequestWywołanie dowolnego API (REST, GraphQL, SOAP)
  • Respond to WebhookOdpowiedź na żądanie, które uruchomiło workflow
  • Execute Sub-workflowWywołaj inny workflow jako sub-workflow
  • Sticky NoteNotatka na kanwie: opis sekcji workflow

AI

  • AI AgentAgent z modelem, pamięcią i narzędziami
  • Call n8n Sub-Workflow ToolDowolny workflow jako narzędzie agenta
  • MCP Client ToolNarzędzia z zewnętrznego serwera MCP dla agenta
  • MCP Server TriggerWystaw narzędzia n8n jako serwer MCP dla zewnętrznych klientów AI
  • $fromAI()Parametr narzędzia, który wypełnia model
  • EvaluationsTesty workflow AI na zbiorze przypadków (Evaluation Trigger + node Evaluation)

Dane bieżącego itemu

  • $jsonDane JSON bieżącego itemu
  • $json (zagnieżdżone)Pole wewnątrz obiektu
  • $json (lista)Element listy po indeksie
  • $binaryPlik dołączony do itemu (tu: nazwa pliku)
  • $itemIndexNumer bieżącego itemu, liczony od 0

Dane z innych nodów

  • $('Nazwa noda')Item z innego noda powiązany z bieżącym
  • .first()Pierwszy item z noda
  • .last()Ostatni item z noda
  • .all()Wszystkie itemy z noda (lista)
  • .all()[N]Konkretny item po indeksie
  • .isExecutedCzy node w ogóle się wykonał

Wejście i kontekst

  • $input.itemItem wejściowy bieżącego noda
  • $input.first()Pierwszy item wejścia
  • $input.all()Wszystkie itemy wejścia
  • $nowBieżąca data i godzina (obiekt Luxon)
  • $todayDzisiejsza data, początek dnia
  • $if()Warunek w jednej linii
  • $ifEmpty()Wartość zastępcza, gdy pole jest puste
  • $execution.idID bieżącego wykonania
  • $execution.modetest (uruchomienie ręczne) albo production (automatyczne)
  • $execution.resumeUrlAdres wznawiający workflow, który czeka na nodzie Wait
  • $workflow.idID bieżącego workflow
  • $workflow.nameNazwa workflow
  • $varsZmienne n8n (zakładka Variables, płatne plany): tylko do odczytu, zawsze tekst

Tekst

  • .toLowerCase()Małe litery
  • .toUpperCase()Wielkie litery
  • .trim()Usuń spacje z początku i końca
  • .replaceAll()Zamień fragment tekstu
  • .split()Podziel tekst na listę
  • .slice()Wytnij fragment
  • .includes()Czy tekst zawiera fragment
  • .isEmpty()Czy tekst jest pusty (metoda n8n)
  • .extractEmail()Wyciągnij adres e-mail z tekstu (metoda n8n)

Daty (Luxon)

  • .toFormat()Data w wybranym formacie
  • .plus()Dodaj czas
  • .minus()Odejmij czas
  • .diffTo()Różnica między datami w wybranej jednostce (metoda n8n)
  • DateTime.fromISO()Zamień tekst ISO na datę
  • .toDateTime()Zamień tekst na datę (metoda n8n)

Webhook

  • HTTP MethodGET, POST, PUT, PATCH, DELETE, HEAD
  • PathKońcówka adresu, np. /nowe-zamowienie
  • AuthenticationNone, Basic Auth, Header Auth, JWT Auth, n8n User Auth (OAuth2)
  • RespondImmediately, When Last Node Finishes, Using 'Respond to Webhook' Node, Streaming
  • Test URLDziała tylko podczas nasłuchiwania w edytorze (Listen for test event)
  • Production URLDziała po opublikowaniu workflow (Publish)
  • PlikiWebhook przyjmuje pliki (form-data albo surowe dane)
  • Limit wielkościDomyślnie do 16 MB; na własnym serwerze zmienia to N8N_PAYLOAD_SIZE_MAX

Respond to Webhook

  • JSONOdpowiedz danymi w formacie JSON
  • TextOdpowiedz zwykłym tekstem albo HTML-em
  • Binary FileOdeślij plik (PDF, obraz)
  • Redirect / No DataPrzekierowanie albo odpowiedź bez treści
  • Response Code i HeadersWłasny kod odpowiedzi i nagłówki (w opcjach noda)

Schedule Trigger

  • IntervalCo N sekund, minut, godzin, dni, tygodni albo miesięcy
  • CronTu: dni robocze o 9:00
  • Strefa czasowaUstawiasz w Workflow Settings → Timezone (np. Europe/Warsaw), nie w samym nodzie

Popularne triggery integracji

  • Gmail TriggerNowe maile (sprawdzane co ustalony czas)
  • Google Sheets TriggerNowe albo zmienione wiersze
  • Telegram TriggerWiadomości i zdarzenia bota
  • GitHub TriggerZdarzenia w repozytorium (push, pull request, issue)
  • Airtable TriggerNowe albo zmienione rekordy

Tryby

  • Run Once for All ItemsKod wykonuje się raz i widzi wszystkie itemy: $input.all()
  • Run Once for Each ItemKod wykonuje się osobno dla każdego itemu: $input.item

Wzorce: wszystkie itemy naraz

  • Dodaj pole do każdego itemuZwracasz listę obiektów z kluczem json
  • FiltrujZostaw itemy spełniające warunek
  • Policz według polaJeden item z licznikami
  • Lista na osobne itemyTo samo robi node Split Out

Wzorce: jeden item

  • Zmień strukturę itemuZwracasz jeden obiekt z kluczem json
  • Zgłoś błądPrzerywa workflow czytelnym komunikatem

Ograniczenia

  • Nie ma fetch()Do wywołań API służy node HTTP Request – tam działają credentials, ponawianie i paginacja
  • Bez dostępu do credentialsWywołania z autoryzacją rób nodem HTTP Request z podpiętym credentialem
  • Bez zmiennych środowiskowychOd n8n 2.0 Code node domyślnie ich nie czyta (N8N_BLOCK_ENV_ACCESS_IN_NODE)
  • Moduły npmDomyślnie zablokowane; na własnym serwerze włącza je NODE_FUNCTION_ALLOW_BUILTIN i NODE_FUNCTION_ALLOW_EXTERNAL
  • console.log()Przy ręcznym uruchomieniu wynik widać w konsoli przeglądarki (DevTools)
  • PythonOd n8n 2.0 natywny (bez Pyodide): dane w _items i _item, pola w nawiasach kwadratowych

Ustawienia noda (Settings)

  • On Error: Stop WorkflowBłąd zatrzymuje cały workflow
  • On Error: ContinueWorkflow idzie dalej mimo błędu
  • On Error: Continue (using error output)Błąd trafia na osobne wyjście noda – podpinasz tam własną obsługę
  • Retry On FailPonów nieudany node automatycznie
  • Max TriesLiczba prób: domyślnie 3, najwyżej 5
  • Wait Between TriesPrzerwa między próbami w ms: domyślnie 1000, najwyżej 5000

Error Workflow

  • Error WorkflowOsobny workflow zaczynający się od Error Trigger; wskazujesz go w Workflow Settings
  • Co dostajeszexecution (id, url, lastNodeExecuted, error.message) i workflow (id, name)
  • Link do nieudanego wykonaniaWklej do powiadomienia, żeby jednym kliknięciem zobaczyć błąd

Wzorce

  • Osobna gałąź na błądContinue (using error output) → gałąź, która loguje albo naprawia
  • PowiadomienieError Workflow → Slack, e-mail albo Telegram z nazwą workflow i linkiem
  • Lista do ręcznego przegląduNieudane itemy zapisuj do Data Table albo arkusza, zamiast je gubić
  • Limit czasuWorkflow Settings → Timeout Workflow: przerwij wykonanie, które trwa za długo

Podstawy

  • Import cURLWklej polecenie curl z dokumentacji API, a n8n uzupełni node
  • MethodGET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
  • URLStały adres albo z wyrażeniem
  • AuthenticationNone, Predefined Credential Type (logowanie gotowej integracji) albo Generic Credential Type
  • Send HeadersWłasne nagłówki, np. Content-Type
  • Send Query ParametersParametry adresu jako osobne pola zamiast doklejania do URL
  • Send BodyJSON, Form Urlencoded, Form-Data, n8n Binary File, Raw

Opcje

  • PaginationPobieranie kolejnych stron: Update a Parameter in Each Request albo Response Contains Next URL
  • BatchingItems per Batch i Batch Interval – żeby nie przekroczyć limitu zapytań
  • Never ErrorNie przerywaj przy odpowiedzi spoza 2xx – obsłużysz ją samodzielnie
  • Response FormatAutodetect, JSON, Text albo File
  • TimeoutJak długo czekać na odpowiedź (ms)
  • RedirectsCzy podążać za przekierowaniami
  • ProxyAdres proxy HTTP, np. http://myproxy:3128
  • Ignore SSL IssuesPomija błędy certyfikatu – tylko do testów

Wzorce

  • Stały token albo klucz APIGeneric Credential Type → Header Auth; sekret zostaje w credentialu, nie w polu noda
  • Token pobrany w tym samym workflowJedyny przypadek, gdy token wpisujesz wyrażeniem w nagłówku
  • JSON z danymi z workflowBezpieczniej niż wklejanie wyrażeń w cudzysłowy – znaki specjalne nie popsują JSON-a
  • Wysyłka plikuBody: Form-Data, typ pola n8n Binary File
  • GraphQLPOST z polami query i variables w JSON-ie (jest też osobny node GraphQL)

Rodzaje

  • DedykowaneGotowe typy dla integracji (Google, Slack, OpenAI…)
  • Header AuthWłasna nazwa i wartość nagłówka – najczęstszy sposób na klucz API
  • Query AuthKlucz API jako parametr adresu
  • Basic AuthLogin i hasło
  • OAuth2Logowanie przez okno dostawcy; n8n sam odświeża token

Zarządzanie

  • TworzenieCreate → Credential albo prosto z pola Credential w nodzie
  • Test połączenian8n sprawdza credential przy zapisie
  • UdostępnianieCredential należy do osoby albo projektu; można go udostępnić bez pokazywania sekretu

Zasady

  • Predefined Credential Type w HTTP RequestUżyj logowania istniejącej integracji do wywołań, których jej node nie obsługuje
  • Sekretu nie odczytasz wyrażeniemCredential podpinasz w nodzie; w wyrażeniach i w Code node jego wartości nie ma
  • Żadnych kluczy w polach nodówKlucz wpisany w Edit Fields albo w nagłówku zostaje w JSON-ie workflow i w historii wykonań

Porządek w workflow

  • Nazwy nodówOpisowe („Pobierz zamówienia”), nie „HTTP Request1”
  • Sticky NotesOpisuj sekcje workflow notatkami
  • Sub-workflowPowtarzaną logikę wydziel do osobnego workflow
  • Error WorkflowNa produkcji ustaw go w każdym workflow
  • PublishZmiany zapisują się jako szkic; produkcja działa na wersji opublikowanej
  • Kopia w GitEksportuj workflow do JSON i trzymaj w repozytorium

Wydajność i limity

  • Paczki zapytańLoop Over Items albo Batching w HTTP Request, żeby nie przekroczyć limitu API
  • PrzerwyWait między paczkami, gdy API ma limit na minutę
  • Mniej danychEdit Fields z wyłączonym Include Other Input Fields zostawia tylko potrzebne pola
  • Gałęzie idą po kolein8n nie wykonuje gałęzi równolegle; wyniki łączysz nodem Merge

Popularne wzorce

  • PaginacjaNajpierw opcja Pagination w HTTP Request; własna pętla z If dopiero, gdy API do niej nie pasuje
  • UpsertSzukaj → If istnieje → Update, inaczej Create (wiele nodów ma gotową operację Upsert)
  • Tylko nowe rekordyRemove Duplicates → Remove Items Processed in Previous Executions
  • Akceptacja przez człowiekaWyślij link $execution.resumeUrl → Wait (On Webhook Call) → dalej po kliknięciu
  • OdpytywanieSchedule Trigger → pobierz dane → odfiltruj już przetworzone → działaj

Parametry w JSON-ie (API, MCP, agenci)

  • If: równe (wielkość liter ma znaczenie)
  • If: tekst zawiera fragment
  • If: pole puste (w interfejsie: is empty)
  • If: pole niepuste (w interfejsie: is not empty)
  • If: większe / mniejsze niż
  • If: dopasowanie wyrażeniem regularnym
  • renameOutputSwitch: włącza własne nazwy wyjść
  • Switch: nazwa wyjścia reguły
  • typeValidation: looseIf i Switch: luźne porównywanie typów (w interfejsie: Convert types where required)

Znasz już nody. Czas je połączyć.

Ściąga podpowie składnię. Workflow trzeba zbudować.

W Masterclass n8n budujesz automatyzacje krok po kroku – tak, żeby powtarzalna robota robiła się sama.