Krótka odpowiedź
Facebook Sharing Debugger otwierasz na developers.facebook.com/tools/debug, wklejasz adres strony i klikasz Scrape Again, żeby wymusić ponowne pobranie strony i skasować nieaktualny podgląd linku1. Do zalogowania wystarczy zwykłe konto na Facebooku, konto dewelopera nie jest potrzebne. Jeśli po odświeżeniu podgląd nadal jest zły, sprawdź, czy tagi Open Graph w <head> strony są poprawne i publicznie dostępne, bez logowania.
Wrzucasz link na Facebooka, a zamiast ładnego podglądu z obrazkiem i tytułem widzisz biały prostokąt albo zdjęcie z zupełnie innego artykułu sprzed roku. To nie wina Facebooka ani Twojej strony, tylko cache scrapera – Sharing Debugger pokazuje dokładnie to, co widzi crawler Facebooka, i pozwala wymusić odświeżenie tego podglądu w pół minuty.
To oficjalne, darmowe narzędzie Mety. W tym tekście pokazuję, jak go używać, jakie tagi Open Graph musisz mieć na stronie i jak rozszyfrować błędy, które wyrzuca.
Czym jest Facebook Sharing Debugger i gdzie go znaleźć
Sharing Debugger to narzędzie Meta dostępne pod adresem developers.facebook.com/tools/debug1. Wklejasz adres strony, a debugger pobiera ją dokładnie tak, jak robi to crawler Facebooka, i pokazuje, co widzi: tytuł, opis, obrazek, wszystkie tagi Open Graph oraz ewentualne błędy i ostrzeżenia.
Drugie zastosowanie jest równie ważne: wymuszenie odświeżenia cache. Meta przechowuje podgląd linku przez dłuższy czas i nie aktualizuje go automatycznie przy każdej zmianie strony, więc bez debuggera nie masz jak go skasować2. Do zalogowania wystarczy zwykłe konto użytkownika, osobne konto dewelopera nie jest potrzebne.
To inne narzędzie niż Facebook Pixel, który służy do śledzenia konwersji i zdarzeń na stronie, a nie do podglądu linków – więcej o nim w tekście czym jest Facebook Pixel.
Jak używać Sharing Debugger krok po kroku
- Otwórz narzędzie i wklej URL. Wejdź na developers.facebook.com/tools/debug, wklej pełny adres strony z HTTPS (np. https://twojadomena.pl/artykul/) i kliknij
Debug. - Przejrzyj, co widzi Facebook. Debugger pokazuje podgląd wizualny linku w feedzie, wszystkie znalezione tagi OG oraz błędy (na czerwono) i ostrzeżenia (na pomarańczowo). Sprawdź, czy tytuł, opis i obrazek są aktualne.
- Wymuś odświeżenie cache. Jeśli dane są nieaktualne, kliknij
Scrape Againna dole sekcji wyników – debugger wymusza w ten sposób ponowne pobranie strony przez crawler Facebooka2. Dla pewności kliknij dwa, trzy razy. - Sprawdź „Time Scraped”. Data przy tym polu mówi, kiedy Facebook ostatnio odświeżył cache dla tego adresu. Po
Scrape Againpowinna wskoczyć aktualna. - Przetestuj udostępnienie. Wróć na Facebooka i wklej link do nowego posta. Podgląd powinien już pokazywać świeże dane. Jeśli nie, powtórz Scrape Again albo daj temu kilka minut.
Tagi Open Graph: co musisz mieć w sekcji <head>
Sharing Debugger czyta tagi Open Graph z sekcji <head> Twojej strony. Bez nich Facebook sam zgaduje tytuł i obrazek, zwykle nietrafnie. Facebook w swoim przewodniku dla webmasterów wskazuje jako podstawę cztery tagi: og:url, og:title, og:description i og:image1. Sam protokół Open Graph jako wymagane wymienia nieco inny zestaw: og:title, og:type, og:image i og:url4 – w praktyce najbezpieczniej mieć komplet.
Wymiary obrazka og:image: dlaczego akurat 1200×630
Facebook zaleca obrazy co najmniej 1200×630 pikseli dla najlepszej jakości na ekranach o wysokiej rozdzielczości, a proporcję możliwie bliską 1,91:1, żeby zdjęcie mieściło się w podglądzie bez kadrowania3. To zalecenie samego Facebooka, nie ogólny wymóg protokołu Open Graph, który proporcji w ogóle nie narzuca.
Minimalny akceptowany rozmiar to 200×200 px. Obrazy mniejsze niż 600×315 px nadal się wyświetlają w podglądzie, tylko w mniejszym rozmiarze3. Maksymalny rozmiar pliku to 8 MB3. Z PNG-ami o dużej liczbie kolorów uważaj, bo plik puchnie, a razem z nim czas ładowania.
Najczęstsze błędy w Sharing Debugger i jak je naprawić
| Błąd lub ostrzeżenie | Przyczyna | Naprawa |
|---|---|---|
Brak og:image | tag nie istnieje albo URL obrazka jest względny | dodaj pełny, bezwzględny URL z HTTPS |
| Obraz za mały | szerokość poniżej 200 px lub nieobsługiwane proporcje | wgraj obrazek co najmniej 1200×630 px |
| Stary tytuł lub obrazek | Facebook korzysta z cache i nie widzi zmiany na stronie automatycznie | kliknij Scrape Again 2–3 razy |
og:url nie zgadza się z adresem | wskazuje na inną wersję strony (www/bez www) | ustaw og:url na ten sam adres co canonical |
| Inferred Property | Facebook sam zgadł tag, bo go nie ma | dodaj brakujący tag ręcznie, nie licz na domysły |
| robots.txt blokuje Facebooka | crawler facebookexternalhit jest zablokowany2 | w robots.txt dopuść tego user-agenta do strony |
Osobny przypadek to strony za logowaniem lub paywallem. Jeśli treść wymaga zalogowania, crawler Facebooka jej nie zobaczy, dostanie tylko ekran logowania. Dlatego og:image i og:title muszą być dostępne publicznie, bez sprawdzania sesji czy ciasteczek.
Odpowiedniki Sharing Debugger dla innych platform
Każda większa platforma ma własny walidator podglądu, działający na tej samej zasadzie: wklej URL, sprawdź podgląd, wymuś odświeżenie.
| Platforma | Narzędzie | Co sprawdza |
|---|---|---|
Post Inspector (linkedin.com/post-inspector) | podgląd OG i wymuszenie odświeżenia cache | |
| X (Twitter) | Card Validator (cards-dev.twitter.com/validator) | osobne tagi twitter:card, title, image |
Rich Results Test (search.google.com/test/rich-results) | dane strukturalne Schema.org, nie OG |
Jeszcze słowo o WordPressie. Jeśli używasz Yoast SEO albo Rank Math, tagi OG generują się automatycznie, sprawdź tylko w ustawieniach wtyczki, czy sekcja społecznościowa jest włączona. Bez wtyczki musisz dodać tagi ręcznie w szablonie motywu (header.php) albo przez functions.php.
Najczęstsze pytania o Facebook Sharing Debugger
Co to jest Facebook Sharing Debugger?
To oficjalne narzędzie Mety do sprawdzania, jak linki wyglądają po udostępnieniu na Facebooku, Messengerze i Instagramie. Pokazuje tagi Open Graph (og:title, og:description, og:image), które widzi crawler Facebooka, oraz błędy i ostrzeżenia w ich implementacji.
Drugie zastosowanie to wymuszenie odświeżenia cache. Meta trzyma podgląd linku przez dłuższy czas i nie aktualizuje go automatycznie po zmianie strony, a Scrape Again w debuggerze wymusza jego ponowne pobranie.
Jak odświeżyć podgląd linku na Facebooku?
Wejdź na developers.facebook.com/tools/debug, wklej URL i kliknij Debug. Następnie kliknij Scrape Again dwa, trzy razy, żeby Facebook ponownie pobrał stronę i zaktualizował cache.
Po kilku minutach wróć na Facebooka i wklej link do nowego posta. Podgląd powinien już pokazywać aktualny obrazek i tytuł.
Jakie wymiary powinna mieć grafika og:image?
Facebook zaleca co najmniej 1200×630 pikseli, czyli proporcję możliwie bliską 1,91:1. Ten rozmiar działa i na desktopie (duży podgląd), i na mobile (karta z miniaturą). Format JPG lub PNG, maksymalnie 8 MB.
Minimum akceptowane przez Facebook to 200×200 px. Obrazy mniejsze niż 600×315 px nadal się wyświetlają, tylko w mniejszym rozmiarze.
Dlaczego Facebook pokazuje stary obrazek mimo zmiany na stronie?
Facebook cachuje podglądy linków przez dłuższy czas i nie zauważa zmiany og:image na serwerze automatycznie. Jedyny sposób to Sharing Debugger i Scrape Again.
Jeśli mimo to widzisz stary obraz, sprawdź, czy og:image wskazuje na właściwy adres (bezwzględny, z HTTPS), czy plik jest publicznie dostępny i czy robots.txt nie blokuje crawlera facebookexternalhit.
Czy Sharing Debugger działa dla Instagrama i Messengera?
Tak. Debugger weryfikuje podgląd używany w aplikacjach Mety: Facebooku, Instagramie i Messengerze, które czytają te same tagi Open Graph ze strony. Scrape Again pomaga więc odświeżyć podgląd niezależnie od tego, w której aplikacji link się pojawia.
Źródła
Zweryfikowano: wrzesień 2026Tagi Open Graph, wymogi obrazu i mechanizm cache sprawdziliśmy w oficjalnej dokumentacji Meta for Developers oraz w specyfikacji Open Graph.
- Sharing on Facebook (Webmasters)
- The Facebook Crawler
- Preview Link Images (og:image)
- The Open Graph protocol
