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)
n8n Cheat Sheet · n8n 2.48.6 · robisiesamo.pl/sciagi/n8n