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. Facebook Sharing Debugger pokazuje dokładnie to, co widzi crawler Facebooka, i pozwala wymusić odświeżenie tego cache w pół minuty.
To oficjalne narzędzie Mety, darmowe, a do działania wystarczy zwykłe konto na Facebooku. W tym tekście pokazuję, jak go używać, jakie tagi 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/debug. 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 nawet do 30 dni i bez debuggera nie masz jak go skasować. Do zalogowania wystarczy zwykłe konto użytkownika, osobne konto dewelopera nie jest potrzebne.
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. Facebook pobierze stronę ponownie. 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. Te cztery tagi to absolutne minimum:
<meta property=„og:title” content=„Tytuł artykułu, maks. 60 znaków” />
<meta property=„og:description” content=„Opis do 155 znaków, pojawi się pod tytułem.” />
<meta property=„og:image” content=„https://twojadomena.pl/obrazek.jpg” />
<meta property=„og:url” content=„https://twojadomena.pl/artykul/” />
<!– Zalecane dodatkowo –>
<meta property=„og:type” content=„article” />
<meta property=„og:site_name” content=„Nazwa serwisu” />
<meta property=„og:image:width” content=„1200” />
<meta property=„og:image:height” content=„630” />
Wymiary obrazka og:image: dlaczego akurat 1200×630
Facebook przyjmuje różne rozmiary, ale 1200×630 pikseli to standard, który działa wszędzie: i w dużych podglądach na desktopie, i w mobilnych kartach. Proporcja 1,91:1 pochodzi wprost ze specyfikacji Open Graph.
Minimum akceptowane to 200×200 px, ale poniżej 600 px szerokości obraz bywa pomijany i Facebook pokazuje sam tekst. Format JPG lub PNG, do 8 MB. 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 (do 30 dni) | 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 zablokowany |
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 do 30 dni, a Scrape Again w debuggerze kasuje go i wymusza ponowne pobranie strony.
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?
Standard to 1200×630 pikseli, czyli proporcja 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, ale przy szerokości poniżej 600 px obraz często jest pomijany i zostaje sam tekst.
Dlaczego Facebook pokazuje stary obrazek mimo zmiany na stronie?
Facebook agresywnie cachuje podglądy, nawet do 30 dni, 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 dla wszystkich aplikacji Mety: Facebooka, Instagrama i Messengera. Wszystkie czytają te same tagi Open Graph i korzystają ze wspólnego cache, więc jedno Scrape Again aktualizuje podgląd we wszystkich trzech.
