Facebook Debugger: jak naprawić podgląd i miniaturkę linku

Ikony mediów społecznościowych na ekranie telefonu, ilustracja podglądu linku i Facebook Debuggera

Znasz ten moment: poprawiasz obrazek i tytuł artykułu, wklejasz link na Facebooka – a tam dalej stara miniaturka. Odświeżasz, czyścisz cache przeglądarki, wklejasz jeszcze raz. Nic. To nie błąd Twojej strony, tylko cache po stronie Facebooka, który raz pobrany podgląd potrafi trzymać tygodniami. Na szczęście istnieje oficjalny przycisk reset – i kilka rzeczy, które warto przy okazji zrozumieć, żeby problem nie wracał.

Czym jest Facebook Debugger

Sharing Debugger (potocznie: Facebook Debugger) to darmowe narzędzie Meta pokazujące, jak dokładnie Facebook widzi Twój link: jaki tytuł, opis i obrazek pobrał, kiedy ostatnio to zrobił i jakie błędy napotkał po drodze. Znajdziesz je na developers.facebook.com/tools/debug/ – wystarczy zalogowanie zwykłym kontem Facebook, żadnej aplikacji deweloperskiej nie potrzebujesz.

Podgląd linku nie bierze się z magii, tylko z tagów Open Graph w sekcji head Twojej strony: og:title, og:description, og:image i og:url. Crawler Facebooka (przedstawia się jako facebookexternalhit) czyta je przy pierwszym udostępnieniu i zapisuje wynik w cache. I tu leży źródło 90% problemów: kolejne udostępnienia korzystają z cache, nie z aktualnej strony.

Bonus, o którym mało kto wie: Open Graph wymyślony przez Facebooka w 2010 roku stał się standardem całego internetu. Te same tagi czytają Messenger, WhatsApp, Slack, Discord i LinkedIn – naprawiając OG dla Facebooka, naprawiasz podgląd linku praktycznie wszędzie.

Jak odświeżyć miniaturkę linku krok po kroku

  1. Wejdź na developers.facebook.com/tools/debug/ i zaloguj się kontem Facebook.
  2. Wklej pełny adres URL (z https:// i dokładnie w tej wersji, którą udostępniasz) i kliknij „Debug”.
  3. Spójrz na pole „Time Scraped”. Zobaczysz, kiedy Facebook ostatnio pobrał dane – jeśli przed Twoimi zmianami, to masz wyjaśnienie starej miniaturki.
  4. Kliknij „Scrape Again” (Pobierz ponownie). Facebook pobierze stronę od nowa i pokaże świeży podgląd. Czasem trzeba kliknąć dwa razy – pierwsze pobranie potrafi jeszcze sięgnąć do starego obrazka.
  5. Przejrzyj sekcję ostrzeżeń. Debugger wypisze brakujące tagi, problemy z obrazkiem i przekierowania – to checklista do naprawy, nie dekoracja.

Od tego momentu nowy podgląd ładuje się przy każdym wklejeniu linku – w postach, komentarzach i Messengerze. Jeśli zmieniałeś obrazki na wielu podstronach naraz (np. po rebrandingu), zamiast klikać każdy URL osobno użyj zakładki Batch Invalidator w tych samych narzędziach Meta – przyjmuje listę adresów hurtem.

Typowe problemy i co naprawdę oznaczają

Objaw Przyczyna Rozwiązanie
Stara miniaturka cache Facebooka Scrape Again w Debuggerze
Losowy obrazek ze strony brak tagu og:image dodaj og:image (wtyczka SEO w WP robi to sama)
Pusty podgląd crawler zablokowany w robots.txt / firewall odblokuj user-agent facebookexternalhit
Miniaturka ucięta/rozmazana obrazek za mały lub złe proporcje 1200×630 px (1,91:1), minimum 200×200
Podgląd innej strony przekierowanie lub og:url na inny adres sprawdź łańcuch redirectów w Debuggerze
Brak obrazka przy PIERWSZYM udostępnieniu FB nie zna wymiarów, renderuje asynchronicznie dodaj og:image:width i og:image:height

Ostatni wiersz to najmniej znany trik z tej tabeli. Przy pierwszym scrape Facebook pobiera obrazek w tle – i potrafi pokazać post bez miniaturki, zanim skończy. Jawne podanie wymiarów w og:image:width i og:image:height pozwala wyrenderować podgląd od razu. Dla stron, gdzie liczy się pierwsze udostępnienie (premiery, kampanie), to różnica między postem z obrazkiem a gołym linkiem.

Druga pułapka warta akapitu: obrazki dociągane JavaScriptem (lazy-load) bywają dla crawlera niewidzialne. og:image musi siedzieć w statycznym HTML źródła strony – Debugger zresztą pokaże Ci dokładnie, co zobaczył crawler, więc rozstrzygniesz to w 10 sekund.

Skąd się biorą tagi Open Graph na Twojej stronie

W WordPressie nie piszesz ich ręcznie – robi to wtyczka SEO. Yoast i Rank Math mają w ustawieniach każdego wpisu sekcję społecznościową, gdzie ustawisz osobny tytuł, opis i obrazek pod Facebooka (mogą różnić się od wersji dla Google – i często powinny, bo co innego klika się w SERP-ach, a co innego w feedzie). Te same wtyczki generują też dane strukturalne schema.org – warstwa dla Google i warstwa dla social mediów żyją obok siebie w tym samym head.

Zasada nadrzędna przy meta tagach pozostaje ta sama, co w SEO: konkretny tytuł i opis pod intencję odbiorcy, nie spis słów kluczowych – więcej o tym w tekście o optymalizacji meta tagów title i description.

A jeśli prowadzisz kampanie na Facebooku, podgląd linku to dopiero początek tematu danych – mierzeniem konwersji zajmuje się Facebook Pixel, zupełnie osobny mechanizm.

Odpowiedniki dla LinkedIn i X

LinkedIn ma własny cache i własne narzędzie: Post Inspector (linkedin.com/post-inspector) – działa identycznie jak Debugger, wklejasz URL i wymuszasz odświeżenie. Czyta te same tagi Open Graph.

X (dawny Twitter) wycofał podgląd w swoim Card Validatorze – karty z tagami twitter:card nadal działają, ale podgląd sprawdzisz tylko publikując tweeta (np. na koncie testowym). W praktyce: jeśli OG jest poprawny, karty X zwykle też – X potrafi czytać Open Graph jako fallback.

Gdy mimo wszystko podgląd nie chce współpracować i podejrzewasz problem po stronie platformy, pozostaje kontakt z pomocą Facebooka – choć w 99% przypadków odpowiedź i tak znajdziesz w ostrzeżeniach Debuggera.

Najczęściej zadawane pytania

Co to jest Facebook Debugger?

To oficjalne narzędzie Meta (Sharing Debugger) pokazujące, jak Facebook widzi Twój link: pobrany tytuł, opis, miniaturkę, datę ostatniego pobrania i listę błędów w tagach Open Graph.

Adres: developers.facebook.com/tools/debug/ – wymaga tylko zalogowania na konto Facebook.

Dlaczego Facebook pokazuje starą miniaturkę linku?

Bo trzyma podgląd w cache od pierwszego udostępnienia i nie sprawdza strony przy każdym wklejeniu. Twoje zmiany są na stronie, ale Facebook ich nie widzi.

Rozwiązanie: wklej adres w Sharing Debugger i kliknij „Scrape Again” – podgląd odświeży się od razu, czasem po dwóch kliknięciach.

Jaki rozmiar powinna mieć miniaturka (og:image)?

Zalecane 1200×630 px, czyli proporcja 1,91:1 – tak Facebook wyświetla duże podglądy na desktopie i mobile. Minimum to 200×200 px, poniżej obrazek nie zostanie użyty.

Warto też dopisać og:image:width i og:image:height – wtedy miniaturka renderuje się poprawnie już przy pierwszym udostępnieniu.

Czy Facebook Debugger jest darmowy?

Tak, w pełni – jak wszystkie narzędzia w sekcji Meta for Developers. Potrzebujesz wyłącznie zwykłego konta Facebook.

Do hurtowego odświeżania wielu adresów służy darmowy Batch Invalidator w tym samym zestawie narzędzi.

Co zrobić, gdy Debugger pokazuje pusty podgląd?

Najczęściej crawler Facebooka jest blokowany – sprawdź, czy robots.txt, firewall albo wtyczka bezpieczeństwa nie odcina user-agenta facebookexternalhit. Debugger pokaże kod odpowiedzi serwera, jaki dostał.

Druga opcja: strona w ogóle nie ma tagów Open Graph w statycznym HTML – np. obrazek jest wstawiany JavaScriptem, którego crawler nie wykonuje.

Jak odświeżyć podgląd linku na LinkedIn i X?

LinkedIn: Post Inspector (linkedin.com/post-inspector) – wklejasz URL, narzędzie pobiera stronę na nowo i pokazuje podgląd, czytając te same tagi Open Graph.

X wycofał publiczny podgląd w Card Validatorze – karty działają nadal, ale efekt zobaczysz dopiero publikując post. Poprawny Open Graph zwykle załatwia i ten przypadek.

Picture of Tomasz Zieliński
Tomasz Zieliński

Tomasz zajmuje się tematyką SEO, sztucznej inteligencji i automatyzacji pracy w marketingu internetowym. W swoich artykułach analizuje zmiany w algorytmach wyszukiwarek, rozwój narzędzi AI oraz nowe sposoby tworzenia i optymalizacji treści. Interesuje go przede wszystkim to, jak technologia wpływa na codzienną pracę specjalistów SEO, marketerów i twórców internetowych.

Facebook
Twitter
LinkedIn
Pinterest

Najnowsze Wpisy

Śledź nas