Problemy z WPForms w WordPress – 5 najczęstszych błędów i jak je naprawić

Najczęstsza przyczyna nie leży w samej wtyczce WPForms, tylko w sposobie, w jaki WordPress próbuje wysłać wiadomość. Domyślnie WordPress korzysta z funkcji PHP mail(), która na większości hostingów jest zawodna albo wprost zablokowana. List wychodzi bez uwierzytelnienia, więc serwery odbiorcy traktują go jako podejrzany i odrzucają lub wrzucają do spamu.

Typowe źródła problemu:

• mail() vs SMTP – brak uwierzytelnionej wysyłki przez SMTP to przyczyna numer jeden. Rozwiązaniem jest wtyczka SMTP (opisana niżej).
• Adres nadawcy spoza domeny – jeśli formularz wysyła maile z adresu w stylu wordpress@twojadomena.pl albo z innej domeny niż strona, serwer odbiorcy odrzuca wiadomość przez niezgodność z SPF.
• Błędny adres odbiorcy w powiadomieniu – literówka w polu Wyślij do adresu e-mail w ustawieniach powiadomień WPForms.
• Wyłączone lub puste powiadomienie – ktoś przypadkiem usunął blok Powiadomienia w zakładce Ustawienia formularza.
• Ograniczenia hostingu – limit wysyłki maili na godzinę albo zablokowany port SMTP.

Zanim cokolwiek zmienisz, warto ustalić, czy maile w ogóle wychodzą z serwera – tym zajmiemy się w następnym kroku. Więcej o samej konfiguracji poczty znajdziesz we wpisie konfiguracja SMTP w WordPress.

Naprawianie na ślepo to strata czasu. Najpierw ustal, na którym etapie wiadomość ginie.

1. Test wysyłki z WordPress – zainstaluj wtyczkę SMTP (np. WP Mail SMTP) i użyj jej funkcji Email Test. Jeśli test nie dochodzi, problem jest po stronie wysyłki serwera, nie samego WPForms.
2. Sprawdź folder spam odbiorcy oraz zakładkę Oferty/Powiadomienia w Gmailu. Bardzo często maile docierają, tylko nie do głównej skrzynki.
3. Zweryfikuj adres odbiorcy – w WPForms wejdź w Ustawienia > Powiadomienia i sprawdź pole Wyślij do adresu e-mail. Upewnij się, że nie ma tam literówki ani starego adresu.
4. Włącz logi maili – większość wtyczek SMTP ma Email Log. Widzisz tam, czy WordPress w ogóle próbował wysłać wiadomość i jaki zwrócił status. To rozdziela dwa scenariusze: WordPress nie wysyła vs WordPress wysyła, ale odbiorca nie dostaje.

Dopiero po tej diagnozie wiesz, czy walczysz z konfiguracją poczty, z dostarczalnością (spam), czy z samym formularzem, który nie przekazuje zgłoszenia.

Jeśli test wysyłki nie dochodzi, potrzebujesz uwierzytelnionej wysyłki przez SMTP. Zamiast polegać na funkcji mail(), WordPress łączy się z serwerem poczty Twojej domeny (lub zewnętrznego dostawcy) loginem i hasłem, dokładnie tak jak program pocztowy.

Najpopularniejsze wtyczki SMTP i ich realne różnice:

• WP Mail SMTP – najpopularniejsza, prosty kreator, integracje z Gmailem, SendLayer, Brevo. Dobra na start.
• FluentSMTP – w pełni darmowa, bez limitów w wersji free, lekka, polecana gdy masz własny serwer SMTP hostingu.
• Post SMTP – rozbudowane logi i powiadomienia o nieudanej wysyłce, dobra dla osób, które chcą monitorować dostarczalność.

Dane, które musisz przygotować przed konfiguracją:

• Host SMTP – np. smtp.twojadomena.pl (znajdziesz w panelu hostingu).
• Port – 465 dla szyfrowania SSL lub 587 dla TLS.
• Szyfrowanie – SSL (465) albo TLS/STARTTLS (587), zgodnie z portem.
• Login – pełny adres skrzynki, np. kontakt@twojadomena.pl.
• Hasło – hasło do tej skrzynki.

Adres nadawcy ustaw na realną skrzynkę w domenie strony – to klucz do tego, by maile nie lądowały w spamie. Pomoże w tym też nasz wpis o konfiguracji SMTP maili.

Przykład na bazie WP Mail SMTP, ale logika jest identyczna w FluentSMTP i Post SMTP:

1. Zainstaluj i aktywuj wtyczkę SMTP z repozytorium WordPress.
2. Wybierz dostawcę – jeśli masz działającą skrzynkę w domenie, wybierz opcję Other SMTP. Dla Gmaila wybierz dedykowaną integrację Google (nie wpisuj zwykłego hasła Gmaila).
3. Wpisz dane – host, port (465 lub 587), typ szyfrowania, login i hasło skrzynki.
4. Ustaw From Email na adres w domenie strony i zaznacz Force From Email, by żadne powiadomienie nie nadpisało go innym adresem.
5. Wyślij test – użyj zakładki Email Test. Wiadomość powinna dotrzeć w kilka sekund.
6. Sprawdź formularz – wyślij realne zgłoszenie przez WPForms i potwierdź, że powiadomienie dochodzi.

Jeśli test SMTP przechodzi, a powiadomienie z WPForms nadal nie dociera, wróć do zakładki Powiadomienia w ustawieniach formularza – problem leży w samej konfiguracji powiadomienia, nie w wysyłce serwera.

To inny problem niż maile: tutaj formularz w ogóle nie przyjmuje zgłoszenia i wyświetla komunikat form was unable to submit albo kręcące się kółko bez końca. WPForms wysyła dane przez AJAX i REST API, więc wina najczęściej leży w warstwie technicznej, nie w ustawieniach maila.

Najczęstsze przyczyny i co sprawdzić:

• Konflikt JavaScript z motywem lub inną wtyczką – otwórz konsolę przeglądarki (F12 > Console) i zobacz, czy pojawia się błąd JS przy wysyłce. To najszybsza droga do winowajcy.
• Zablokowane REST API / AJAX – niektóre wtyczki bezpieczeństwa lub konfiguracje serwera blokują admin-ajax.php albo endpoint REST. Bez nich WPForms nie ma jak przesłać danych.
• Nieaktualny nonce przez cache – jeśli strona z formularzem jest mocno cachowana, token bezpieczeństwa (nonce) wygasa i wysyłka jest odrzucana. Wyklucz strony z formularzami z cache.
• mod_security na serwerze – reguła WAF hostingu może blokować żądanie POST jako podejrzane. Tutaj zwykle trzeba zgłosić się do supportu hostingu.

Jeśli po wyłączeniu cache i wtyczek bezpieczeństwa błąd znika, masz winowajcę. Jeśli nie – kolej na test konfliktu wtyczek opisany niżej.

Czasem problem jest jeszcze prostszy: formularza po prostu nie ma na stronie. Zamiast pól widać pusty obszar albo surowy shortcode w stylu nawiasów kwadratowych z wpforms.

Co sprawdzić:

• Zły shortcode lub ID – upewnij się, że ID formularza w shortcode zgadza się z realnym ID w WPForms. Po skopiowaniu starej treści ID często się nie zgadza.
• Blok WPForms w edytorze – jeśli używasz bloku Gutenberga, sprawdź, czy faktycznie wybrano formularz z listy, a nie pusty placeholder.
• Konflikt motywu lub JavaScript – surowy shortcode widoczny jako tekst oznacza zwykle, że WPForms nie zostało poprawnie wczytane. Konsola przeglądarki znów pomoże.
• Cache i lazy load – stara wersja strony w cache może pokazywać układ sprzed dodania formularza. Wyczyść cache strony (wtyczka) i przeglądarki (Ctrl+F5).
• Lazy load skryptów – agresywne wtyczki optymalizacyjne potrafią opóźnić skrypty WPForms tak, że formularz się nie renderuje. Wyklucz skrypty WPForms z opóźnienia.

Jeśli formularz znika po włączeniu wtyczki cache albo optymalizacji, masz odpowiedź – więcej o tym we wpisie o cache w WordPress.

Tu maile wychodzą i WPForms działa, ale lądujesz w folderze spam odbiorcy. To problem dostarczalności, a więc uwierzytelnienia domeny. Trzy rekordy DNS decydują o tym, czy serwery odbiorcy ufają Twoim wiadomościom:

• SPF – rekord TXT, który mówi, które serwery mogą wysyłać pocztę w imieniu Twojej domeny. Bez niego (albo z niezgodnym adresem nadawcy) maile łapią minus.
• DKIM – podpis kryptograficzny dodawany do nagłówka. Potwierdza, że wiadomość nie została zmieniona po drodze.
• DMARC – polityka mówiąca serwerom, co robić z mailami, które nie przejdą SPF/DKIM.

Praktyczne kroki:

• Ustaw adres nadawcy w domenie strony, nie wordpress@... ani adres z innej domeny.
• Dodaj rekordy SPF i DKIM w panelu DNS (dane otrzymasz od hostingu lub dostawcy poczty). Po konfiguracji SMTP zwykle wystarczy dopisać wpis dostawcy do SPF.
• Ustaw sensowne Reply-To na adres osoby, która ma dostawać zgłoszenia, by odpowiedzi trafiały we właściwe miejsce.

Dla sklepów ten sam mechanizm dotyczy maili transakcyjnych – patrz wpis WooCommerce nie wysyła maili.

Paradoksalnie zabezpieczenia antyspamowe same potrafią zablokować wysyłkę. Jeśli formularz wygląda, jakby działał, ale zgłoszenia nie docierają, sprawdź mechanizmy ochrony.

• reCAPTCHA / hCaptcha z błędnymi kluczami – jeśli klucz witryny i sekretny nie pasują do domeny, weryfikacja zawsze się nie udaje i zgłoszenie jest odrzucane bez wyraźnego komunikatu. Wygeneruj klucze ponownie dla właściwej domeny.
• Anti-spam token WPForms a cache – wbudowany token antyspamowy WPForms wymaga świeżego ładowania strony. Mocny cache zamraża token i blokuje wysyłkę. Wyklucz strony z formularzami z cache lub testowo wyłącz token.
• Akismet – może klasyfikować realne zgłoszenia jako spam. Sprawdź zakładkę ze zgłoszeniami oznaczonymi jako spam w WPForms.
• Wtyczki bezpieczeństwa typu Wordfence – firewall potrafi blokować POST z formularza. Sprawdź logi Wordfence i ewentualnie dodaj wyjątek. Więcej w naszym wpisie o Wordfence i bezpieczeństwie WordPress.

Złoty środek: zabezpieczenia mają chronić, ale po każdej zmianie testuj formularz realnym zgłoszeniem, by nie odciąć sobie leadów.

Gdy nie wiesz, co psuje formularz, metoda eliminacji jest najpewniejsza. Rób to na kopii testowej (staging), jeśli strona jest produkcyjna.

1. Wyczyść cache – najpierw cache wtyczki cachującej, potem cache przeglądarki (Ctrl+F5). Często to wystarcza.
2. Wyłącz wtyczki pojedynczo – zacznij od wtyczek bezpieczeństwa, optymalizacji i innych wtyczek formularzy. Po każdym wyłączeniu testuj WPForms.
3. Przełącz tymczasowo na domyślny motyw (np. Twenty Twenty-Four). Jeśli formularz zadziała, wina leży w motywie albo jego skryptach.
4. Sprawdź konsolę przeglądarki – błędy JS wskazują konkretny plik i wtyczkę.

Gdy znajdziesz winowajcę, zdecyduj: aktualizacja, zamiana na alternatywę albo wyjątek w konfiguracji. Metodyczny opis znajdziesz też we wpisie o najlepszych wtyczkach WordPress 2026.

Część problemów z WPForms jest typowa dla polskich hostingów współdzielonych. Wielu dostawców celowo ogranicza funkcję mail() i kontroluje porty SMTP, by walczyć ze spamem.

• Blokada lub limit mail() – na hostingu współdzielonym wysyłka przez mail() bywa ograniczona do kilkudziesięciu wiadomości na godzinę albo wyłączona. Rozwiązanie to SMTP na skrzynce w Twojej domenie.
• Porty SMTP – używaj 465 (SSL) lub 587 (TLS). Port 25 bywa zablokowany dla wysyłki wychodzącej.
• Własny serwer SMTP hostingu – najprostsza i najtańsza opcja to skrzynka w domenie strony plus dane SMTP z panelu hostingu. Maile wychodzą wtedy z poprawną domeną, co od razu poprawia dostarczalność.
• Kiedy dzwonić do supportu – jeśli test SMTP zwraca timeout albo connection refused, port może być zablokowany od strony serwera. Zgłoś hostingowi konkretny port i komunikat błędu, a poprawią konfigurację.

Wybierając hosting pod WordPress, zwróć uwagę na elastyczność poczty i porty SMTP – podpowiadamy w przewodniku jaki hosting pod WordPress wybrać. Polecamy sprawdzonego dostawcę CyberFolks (zamiast drogich i sztywnych nazwa.pl czy home.pl).

Szybka lista do przejścia od góry do dołu:

• Test wysyłki maila z wtyczki SMTP – dochodzi czy nie?
• Folder spam odbiorcy sprawdzony.
• Adres odbiorcy w powiadomieniu WPForms bez literówki.
• SMTP skonfigurowane (host, port 465/587, szyfrowanie, login, hasło).
• Adres nadawcy w domenie strony, Force From Email włączone.
• SPF i DKIM ustawione w DNS domeny.
• Cache wyczyszczony, strony z formularzami wykluczone z cache.
• Konsola przeglądarki sprawdzona pod kątem błędów JS.
• REST API / admin-ajax nie są blokowane przez wtyczkę bezpieczeństwa.
• Klucze reCAPTCHA/hCaptcha poprawne dla domeny.
• Konflikt wtyczek/motywu wykluczony metodą eliminacji.

Przejście tej listy wyłapuje zdecydowaną większość przypadków. Jeśli formularz nadal nie działa, problem jest zwykle głębszy (konfiguracja serwera, mod_security) i warto oddać go specjaliście.

Niedziałający formularz to nie kosmetyka – to dziura w lejku sprzedażowym. Każde zgłoszenie, które nie dotarło, to potencjalny klient, który poszedł do konkurencji. Jeśli prowadzisz firmę i nie chcesz tracić czasu na diagnozę DNS, portów SMTP i konfliktów wtyczek, taniej wychodzi oddanie tego osobie, która robi to na co dzień.

W KC Mobile naprawiamy formularze, konfigurujemy pocztę SMTP i porządkujemy strony WordPress tak, by leady realnie dochodziły. Zajmujemy się tym w ramach usług WordPress oraz budowy stron internetowych, a po wdrożeniu możemy objąć stronę opieką (od 299 zł/mies.), żeby takie problemy nie wracały. Strony budujemy od 3000 zł.

Masz formularz, który nie wysyła maili albo wyrzuca błąd form was unable to submit? Napisz do nas przez formularz kontaktowy – sprawdzimy, gdzie ginie zgłoszenie, i naprawimy to szybko, bez zgadywania. Mamy 18+ lat doświadczenia i status Google Partner.