og:image się nie wyświetla? Jak to naprawić

Problem z niewyświetlaniem się og:image prawie zawsze sprowadza się do jednej z pięciu przyczyn: adres URL obrazu nie jest publiczny, obraz jest zbyt duży, platforma zapisała w pamięci podręcznej starą wersję, tagi dotyczą niewłaściwej strony lub format obrazu nie jest obsługiwany. Ten przewodnik omawia każdą poprawkę, korzystając z narzędzi do debugowania udostępnianych przez Facebooka, X oraz LinkedIn.

Dlaczego moje og:image się nie wyświetla?

Najczęściej przyczyną jest to, że adres URL obrazu nie jest publicznie dostępny, plik przekracza limity platformy albo platforma pokazuje zapisaną kopię w pamięci podręcznej. Platformy społecznościowe ponownie skanują strony według harmonogramu i agresywnie buforują, więc nowy obraz często wydaje się „nie działać”, dopóki nie wymusisz odświeżenia za pomocą ich narzędzi debugowania.

Pięć najczęstszych przyczyn (i sposoby naprawy)

1. URL obrazu nie jest publiczny

Platformy muszą pobrać obraz bez uwierzytelniania. URL za loginem, localhostem lub adresem IP nie zadziała.

Rozwiązanie: umieść obraz pod publicznym adresem HTTPS i potwierdź, że curl -I <image-url> zwraca 200 OK z obrazem Content-Type.

2. Obraz jest zbyt duży

Większość platform ogranicza obrazy OG do 8 MB (X do ~5 MB). Duży plik PNG zawodzi po cichu.

Rozwiązanie: trzymaj plik poniżej 5 MB; karta tekstowa 1200×630 zwykle waży 200–500 KB. Na FastOG wyjściowy PNG jest już odpowiednio przygotowany.

3. Platforma zapisała w cache starą wersję

Facebook, X, LinkedIn, Slack i Discord agresywnie cache'ują. Meta dodatkowo przechowuje własną kopię obrazu i kluczuje podgląd na URL strony, więc sam nowy URL obrazu nie wystarczy. Po zmianie obrazu stara karta utrzymuje się godzinami lub dniami.

Rozwiązanie: wymuś ponowne pobranie narzędziem platformy (poniżej). Przy zmianie obrazów używaj URL, który zmienia się wraz z treścią (podpisane URL-e FastOG robią to automatycznie). Dla jedynej platformy pozwalającej na programowe odświeżenie zobacz Wymuś odświeżenie cache Open Graph na Facebooku.

4. Zły URL lub zła strona

Znacznik og:image może brakować, być zduplikowany lub wskazywać stronę bez tego znacznika.

Rozwiązanie: wyświetl źródło strony i potwierdź, że znacznik og:image jest obecny, renderowany po stronie serwera i ma absolutny URL.

5. Nieobsługiwany format

Niektóre platformy odrzucają określone formaty lub obrazy animowane.

Rozwiązanie: używaj PNG lub JPG; 1200×630 to obsługiwany współczynnik proporcji.

Narzędzia debugowania

Platforma	Narzędzie
Facebook / WhatsApp	Sharing Debugger — `developers.facebook.com/tools/debug`
X / Twitter	Card Validator — `cards-dev.twitter.com/validator`
LinkedIn	Post Inspector — `linkedin.com/post-inspector`

Wklej adres URL, a następnie kliknij „Scrape” / „Refresh”, aby pobrać najnowsze tagi.

Specyfika FastOG

FastOG renderuje PNG o wymiarach 1200×630 — obsługiwany rozmiar — dzięki czemu problemy z proporcjami czy rozmiarem są wykluczone.
Podpisane URL-e ograniczają tylko pierwsze renderowanie; zbuforowane obrazy pozostają ważne, więc udostępniona karta nadal działa.
Zmiana tytułu → zmiana URL-a → jedno nowe renderowanie. Platforma (docelowo) pobiera nową kartę po wymuszeniu ponownego przeszukania.

FAQ

Czy FastOG gwarantuje, że mój og:image się pojawi?

FastOG dostarcza prawidłowy obraz PNG o wymiarach 1200×630 z publicznego adresu URL. To, czy platforma go wyświetli, zależy od jej pamięci podręcznej — po zmianie obrazu wykonaj ponowne scrapowanie za pomocą walidatora.

Dlaczego Facebook pokazuje stary obraz, nawet po jego aktualizacji?

Facebook buforuje wyniki scrapowania i przechowuje własną kopię obrazu — więc sam nowy adres og:image URL tego nie zmieni. Użyj Sharing Debugger → „Scrape Again”; Wymuszanie odświeżenia pamięci podręcznej Open Graph na Facebooku opisuje ścieżkę API, wymagany token aplikacji oraz limity szybkości, których należy przestrzegać.

Jak wymusić na X wyświetlenie nowej karty?

Otwórz X Card Validator i wklej adres URL. Ponownie pobierze on najnowsze og:image i twitter:image.