Udostępniasz link na LinkedInie, a podgląd nie ma obrazka, ma malutką miniaturkę tam, gdzie powinien być szeroki obrazek, albo obrazek sprzed miesiąca. Podgląd buduje robot LinkedIna, LinkedInBot: pobiera stronę, czyta jej tagi Open Graph i pobiera obrazek. Wszystko, co przerwie któryś z tych kroków, zostawia podgląd pusty, a gdy LinkedIn ma już podgląd danego adresu, trzyma go, dopóki nie odświeżysz go w Post Inspectorze. Ten poradnik zbiera to, co dokumentuje sam LinkedIn, to, co odtworzyliśmy, i naprawę każdej przyczyny.
Co sprawdziliśmy, a czego nie. 21.11.2026 serwowaliśmy strony testowe z lokalnego serwera Node.js i pobieraliśmy je curlem 8 z nagłówkami User-Agent LinkedInBot/1.0, facebookexternalhit/1.1, WhatsApp/2.22.20.72 A i czterech innych robotów podglądu, a obrazki testowe (zrobione w ImageMagicku) puściliśmy przez kontrole platform w naszym OG checkerze. Nie publikowaliśmy stron testowych na LinkedInie — nie były publiczne — więc to, co pokazuje LinkedIn, pochodzi z jego stron pomocy: Make your website shareable on LinkedIn i Use Post Inspector to refresh URL, oraz z dokumentacji Images API dla wysyłanych obrazków. Pełnego nagłówka User-Agent swojego robota LinkedIn na tych stronach nie podaje.
Co dokumentuje LinkedIn
Strona pomocy LinkedIna wymienia cztery tagi, które „must exist” (muszą istnieć): og:title, og:image, og:description i og:url. Dalej idą wymagania wobec obrazka „specific to the LinkedIn sharing module”:
| Zasada | Wartość LinkedIna |
|---|---|
| Maksymalny rozmiar pliku | 5 MB |
| Minimalne wymiary | 1200 (szer.) × 627 (wys.) pikseli |
| Zalecana proporcja | 1,91:1 |
| Formaty | dla podglądu linku nie podano |
Ta sama strona podaje potem specyfikację reklam z jednym obrazkiem — „File types: JPG, PNG, or GIF” — i dodaje: „Images less than 401 pixels wide display as a thumbnail image” (obrazki węższe niż 401 pikseli są wyświetlane jako miniaturka). Kończy się przyczyną, na którą trafia najwięcej osób: jeśli obrazek spełnia wymagania, a mimo to się nie pojawia, „your website may be blocking us from pulling the image or the image may be located on a protected directory or website” — strona może blokować pobieranie obrazka albo obrazek leży w chronionym katalogu.
Najczęściej zawodzi właśnie rozmiar: w naszym spisie 10 000 największych serwisów (2026-11-17) 38,0% zmierzonych obrazków og:image ze stron głównych było mniejszych niż 1200×627 LinkedIna. Obrazek 1200×630, którego większość stron i tak używa dla Facebooka i X, spełnia też minimum LinkedIna; liczby wszystkich platform obok siebie są na stronie rozmiarów obrazka OG.
Co zmierzyliśmy
| Test | Wynik |
|---|---|
| Strona za regułą, która zwraca 403 każdemu User-Agentowi ze słowem „bot” | 403 dla LinkedInBot/1.0, Twitterbot/1.0, Slackbota, TelegramBota, Discordbota; 200 dla facebookexternalhit/1.1 i WhatsApp/2.22.20.72 A |
| PNG 1200×627, 3,1 MB | w limitach LinkedIna |
| PNG 1200×600 | nasz checker: za mały dla LinkedIna (1200×600 wobec 1200×627) |
| PNG 400×209 | za mały dla LinkedIna i dla minimum Facebooka 600×315 |
| PNG 2000×400 | za mały dla LinkedIna: wysokość poniżej 627 |
Pierwszy wiersz tłumaczy częste zgłoszenie: „podgląd działa na Facebooku i w WhatsAppie, ale nie na LinkedInie”. User-Agenty Facebooka i WhatsAppa nie zawierają słowa „bot”, LinkedIna — tak. Każda reguła zapory, wtyczka bezpieczeństwa czy linijka w .htaccess, która dopasowuje „bot”, odprawia LinkedIna, a wpuszcza Facebooka.
Przyczyny po kolei
1. Brakuje tagu albo adres obrazka jest względny
Wszystkie cztery tagi muszą być w HTML-u, który wysyła serwer, z bezwzględnymi adresami: https://example.com/og/post.png, nie /og/post.png. Tagi dodane przez JavaScript po załadowaniu strony się nie liczą — roboty podglądu czytają HTML z serwera. Wklej adres do naszej alternatywy dla LinkedIn Post Inspector: zgłasza brakujące tagi i względne adresy obrazków jako błędy, sprawdza obrazek z limitami LinkedIna i pokazuje podgląd karty, bez logowania do LinkedIna.
2. LinkedInBot jest zablokowany
Przyczyna, którą LinkedIn wymienia sam. Pobierz stronę i obrazek tak jak LinkedIn:
curl -s -A "LinkedInBot/1.0" -o /dev/null -w "%{http_code}\n" https://example.com/post
curl -s -A "LinkedInBot/1.0" -o /dev/null -w "%{http_code} %{content_type} %{size_download}\n" https://example.com/og/post.png
Kod 403 lub 503, strona logowania albo strona „sprawdzamy twoją przeglądarkę” znaczy, że LinkedIn jest odprawiany. Szukaj reguły na „bot” w ustawieniach zapory albo ochrony przed botami, sekcji robots.txt, która zabrania wstępu LinkedInBotowi (albo Disallow: / pod User-agent: *), ochrony przed hotlinkowaniem katalogu z obrazkami albo hasła na wersji testowej.
3. Obrazek jest za mały, za duży albo ma zły kształt
Poniżej 1200×627 LinkedIn może pokazać obrazek mały; poniżej 401 pikseli szerokości według pomocy staje się miniaturką. Powyżej 5 MB wypada poza limit. Nasze dwa testowe JPEG-i 1200×630 ważyły 16 KB (płaski gradient) i 743 KB (losowy szum w jakości 97, niemal najgorszy przypadek), więc obrazek do podglądu nie ma powodu zbliżać się do 5 MB — PNG 3,1 MB z tabeli był wyjątkiem i przekraczałby już 600 KB WhatsAppa.
4. Format, którego LinkedIn nie wymienia
Dla podglądu linku LinkedIn nie wymienia żadnych formatów. Wszędzie, gdzie je wymienia — w reklamach i przy obrazkach wysyłanych przez Images API („JPG, GIF, and PNG formats”) — brakuje WebP, AVIF i SVG. Opisanym wyborem jest więc JPEG lub PNG; og:image w WebP może zadziałać, ale LinkedIn niczego tu nie obiecuje. Porównanie wszystkich platform jest na stronie formatów og:image (po angielsku).
5. Pamięć podręczna LinkedIna
Pomoc LinkedIna: jeśli ten sam adres był już udostępniany, „the image might already have been stored in the cache and that's what you see” — widzisz obrazek zapisany w pamięci podręcznej. Naprawą jest Post Inspector (niżej). Jak długo LinkedIn trzyma tę pamięć, nie podaje.
„Image not available” i urn:li:image
Wyszukiwanie „image not available: urn:li:image:…” nie dotyczy podglądów linków. urn:li:image to obrazek wysłany do LinkedIna — przez narzędzie do planowania postów, integrację albo twój własny kod przez Images API. Dokumentacja API nadaje każdemu takiemu obrazkowi status:
WAITING_UPLOAD— plik jeszcze nie został wysłany albo wysyłanie trwa;PROCESSING— LinkedIn wciąż generuje jego wersje;PROCESSING_FAILED— „due to client error such as file size too large, unsupported file format, internal error … or other issue” (za duży plik, nieobsługiwany format, błąd wewnętrzny i inne);AVAILABLE— „The asset is available to be served” (obrazek można wyświetlić).
API podaje też, że downloadUrl obrazka „is empty if the media asset isn't available, failed processing, etc.” i że adresy pobierania wygasają. Post, który odwołuje się do obrazka, zanim ten osiągnie AVAILABLE, albo którego wysyłka się nie udała, nie ma czego pokazać. Images API obsługuje „Images with less than 36,152,320 pixels” w formatach JPG, GIF i PNG. Tego błędu sami nie odtworzyliśmy — wymaga aplikacji i tokenu LinkedIna — a samego komunikatu LinkedIn nie dokumentuje; jeśli go widzisz, poproś narzędzie, które utworzyło post, o ponowną wysyłkę obrazka jako JPEG lub PNG.
Odśwież podgląd w Post Inspectorze
- Popraw tagi albo obrazek. Jeśli zmieniasz obrazek, nadaj mu nową nazwę pliku (
post-v2.png), żeby żadna pamięć podręczna nie trzymała starego pliku pod tym samym adresem. - Otwórz Post Inspectora, wpisz adres i sprawdź, czy podgląd pokazuje właściwy tytuł i obrazek.
- Utwórz post od nowa.
Uwaga LinkedIna jest ważna: zmiany dotyczą podglądu „for new posts that include it. The preview for any existing posts with this URL will remain the same” — tylko nowych postów; istniejące posty zostają przy starym podglądzie. Żeby zmienić obrazek w poście, który już jest opublikowany, usuń go i opublikuj ponownie. Te same kroki dla Facebooka, X, WhatsAppa, Slacka i reszty są w poradniku jak odświeżyć podgląd linku.
Obrazek zgodny z zasadami LinkedIna na każdej podstronie
Shareglint renderuje dla każdej podstrony obrazek 1200×630 w JPEG lub PNG z szablonu HTML i tytułu strony, pod bezwzględnym adresem HTTPS, który LinkedInBot może pobrać — przez API albo przez podpisany adres obrazka wpisany wprost w tag og:image. Zmiana tytułu zmienia adres, więc LinkedIn nigdy nie trzyma nieaktualnego pliku. Darmowy plan obejmuje 100 obrazków miesięcznie.