TL;DR, szybka odpowiedź
6 min czytaniaParametr alt_text w punkcie końcowym publikowania treści na Instagramie przyjmuje do 1 000 znaków, a dokumentacja Meta ogranicza go do pojedynczego obrazu lub obrazu w karuzeli. Reels i relacje są wprost wymienione jako nieobsługiwane, a żaden kontener wideo nie jest podany jako przyjmujący to pole. Dokumentacja dla deweloperów nie podaje limitu znaków dla pola tekstu alternatywnego w aplikacji Instagram, więc 1 000 to jedyna liczba, którą można poprzeć źródłem.
Jaki jest limit znaków alt_text w API Instagrama?
Dokumentacja Meta ustala limit znaków alt_text w API Instagrama na 1 000 i ogranicza to pole do obrazów statycznych. Opis parametru w punkcie końcowym tworzenia mediów brzmi dosłownie: "Alternative text, up to 1000 character, for an image. Only supported on a single image or image media in a carousel. Reels and stories are not supported."
Jeden opis, trzy osobne zasady. Limit wynosi 1 000. Pole należy do obrazu, samodzielnego lub umieszczonego w karuzeli. Reels i relacje są wykluczone z nazwy. Wszystko inne, co ludzie sądzą o tekście alternatywnym na Instagramie, pochodzi spoza tego opisu.
Pole znajduje się w wywołaniu tworzącym kontener:
POST https://graph.facebook.com/v25.0/<IG_ID>/media
?image_url=https://example.com/photo.jpg
&alt_text=A%20hand-drawn%20site%20plan%20pinned%20to%20a%20studio%20wall
&caption=Week%20four
&access_token=<TOKEN>alt_text przekazujesz przy tworzeniu kontenera, a nie przy publikacji. Krok publikacji, POST /<IG_ID>/media_publish, przyjmuje creation_id i nic więcej, co dotyczyłoby dostępności. Jeśli pominiesz to pole w kontenerze, w tym samym procesie nie będzie drugiej szansy.
Meta podaje dokładną datę wprowadzenia funkcji. Przewodnik po publikowaniu treści mówi: "On March 24, 2025, we introduced the new alt_text field for image posts on the /<INSTAGRAM_PROFESSIONAL_ACCOUNT_ID>/media endpoint. Reels and stories are not supported." Wszystko, co napisano o API publikacji Instagrama przed tą datą, opisuje świat bez programowego tekstu alternatywnego.
- Brak pola alt_text w API publikacji
- Brak programowego sposobu na dodanie opisu obrazu
- Pole alt_text dostępne w punkcie końcowym media
- Do 1 000 znaków, tylko obrazy
Które typy mediów na Instagramie przyjmują alt_text?
Tylko obrazy. Oto pełne zestawienie, oparte na opisie parametru i liście typów mediów z tej samej strony dokumentacji.
| Kontener | alt_text przyjmowany | Co mówi dokumentacja |
|---|---|---|
Pojedynczy obraz (bez media_type) | Tak | "Only supported on a single image" |
Obraz w karuzeli (is_carousel_item=true) | Tak | "or image media in a carousel" |
Kontener karuzeli (media_type=CAROUSEL) | Nie | Pole opisuje obraz, a kontener zawiera elementy podrzędne, a nie piksele |
media_type=REELS | Nie | "Reels and stories are not supported" |
media_type=STORIES | Nie | "Reels and stories are not supported" |
| Wideo | Niewymienione | Parametr dotyczy "for an image"; żaden kontener wideo nie jest opisany jako przyjmujący to pole |
Ostatni wiersz przeczytaj uważnie, bo to on bywa błędnie cytowany. Meta nie pisze "video is not supported". Pisze, że parametr to tekst alternatywny "for an image", a jako wyjątki wymienia Reels i relacje. Ten punkt końcowy publikuje samodzielne wideo jako REELS, co zdanie wyklucza wprost. Praktyczny efekt jest zgodny z powtarzanym skrótem, ale dokumentacja dochodzi do niego przez zakres parametru, a nie przez zakaz, i strona ze specyfikacją powinna to rozróżniać.
Dlaczego liczba w aplikacji różni się od liczby w API?
Dokumentacja Meta dla deweloperów podaje dokładnie jeden limit tekstu alternatywnego: 1 000 znaków dla parametru alt_text. Nie podaje żadnego limitu dla pola tekstu alternatywnego w aplikacji Instagram.
Właśnie tę lukę warto nazwać. Poradniki o dostępności i blogi o mediach społecznościowych powtarzają znacznie krótszą wartość dla aplikacji, cytowaną bez odnośnika do Meta. Nie występuje ona nigdzie w dokumentacji dla deweloperów ani w dzienniku zmian, który nie ma żadnego wpisu o alt_text. Dlatego ta strona jej nie powtarza. Jeśli chcesz wiedzieć, ile znaków zmieści edytor w aplikacji, odpowiedź dostępna od Meta jest taka, że Meta tego nie podaje.
Dostajesz za to konkretną liczbę dla jedynej powierzchni, która się dokumentuje. Jeśli tekst alternatywny przechodzi przez API, masz do dyspozycji 1 000 znaków, i to jedyny budżet, do którego Meta zobowiązuje się na piśmie. Ograniczenie, pod które ludzie planują, okazuje się nie tym, które faktycznie istnieje.
Jak limit alt_text wypada na tle limitu podpisu?
Ta sama strona dokumentacji opisuje oba, więc porównanie jest uczciwe.
| Pole | Limit | Dodatkowe zasady |
|---|---|---|
alt_text | 1 000 znaków | Tylko obrazy. Bez Reels, bez relacji |
caption | 2 200 znaków | Maksymalnie 30 hashtagów i 20 oznaczeń @ |
Opis podpisu w dokumentacji Meta jasno określa liczbę oznaczeń: "Maximum 2200 characters, 30 hashtags, and 20 @ tags." Opis alt_text nie zawiera podobnych zasad szczegółowych. Nie ma udokumentowanego limitu hashtagów, wzmianek ani obsługi znaczników. To zwykłe pole tekstowe z limitem.
Ta asymetria ma znaczenie przy budowie edytora. Walidator podpisu potrzebuje trzech liczników. Walidator tekstu alternatywnego potrzebuje jednego oraz sprawdzenia, jaki typ mediów wybrał użytkownik.

Gdzie umieścić alt_text w poście z karuzelą?
W każdym kontenerze podrzędnym, po kolei. Karuzelę buduje się w dwóch etapach. Najpierw kontener dla każdego elementu z is_carousel_item=true, potem kontener nadrzędny z media_type=CAROUSEL i tablicą children z tymi identyfikatorami. Uwaga Meta przy is_carousel_item brzmi: "Applies only to images and video. Set to true. Indicates image or video appears in a carousel."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Tekst alternatywny dodaje się na poziomie elementu podrzędnego, co wynika z opisu parametru obejmującego "image media in a carousel". Dziesięć slajdów to dziesięć osobnych wartości alt_text, napisanych dla dziesięciu osobnych obrazów. Nie ma pola na poziomie kontenera nadrzędnego opisującego całość ani sposobu na jeden tekst dla całej karuzeli. Zespoły przygotowujące karuzele hurtowo w narzędziu do planowania na Instagramie od razu to odczuwają. Praca nad tekstem alternatywnym rośnie z liczbą slajdów, a nie postów.
Elementy wideo w karuzeli mają ten sam problem z zakresem co samodzielne wideo. Kontener podrzędny przyjmuje is_carousel_item, ale alt_text jest udokumentowany dla obrazów.
Co dzieje się z tekstem alternatywnym w Reels i relacjach?
Nic, bo tam tego pola nie ma. Wysyłając alt_text w kontenerze REELS lub STORIES, przekazujesz parametr, którego punkt końcowy nie dokumentuje. Nie ma częściowej obsługi, przycinania ani przeniesienia do podpisu.
To realna luka dla wszystkich, którzy publikują dużo wideo przez API do publikowania na Instagramie. Opis dostępnościowy musi znaleźć się gdzie indziej, czyli w praktyce w podpisie, w tekście na ekranie albo w napisach wtopionych w wideo. To decyzje redakcyjne, a nie pola API, i ich miejsce jest w kalendarzu treści, z którego korzysta twój zespół.

Jak w praktyce wykorzystać 1 000 znaków?
Większość tekstów alternatywnych ich nie potrzebuje, a długość nie jest celem. Znajomość prawdziwego limitu usuwa jednak błędny powód do skracania. Gdy zdjęcie zawiera wykres, menu, cennik, harmonogram lub gęsty tekst, nie musisz już wybierać między opisem a streszczeniem. Masz miejsce na jedno i drugie.
Przy gęstym obrazie zacznij od tematu i tego, co się dzieje, potem opisz otoczenie, a tekst widoczny w kadrze przepisz, zamiast go parafrazować. Pomiń "obraz przedstawiający" i "zdjęcie przedstawiające", bo technologie asystujące same informują o elemencie. Głos marki zostaw w podpisie, w czym pomaga generator podpisów AI, a w tekście alternatywnym opisuj to, co widać.
Jedyna liczba, pod którą warto projektować, to 1 000 na kontener, tylko dla obrazów. Cała reszta to albo ocena redakcyjna, albo nieudokumentowane zachowanie aplikacji, do którego Meta nie zobowiązała się na piśmie.
Najczęściej zadawane pytania
Jaka jest maksymalna długość alt_text w API Instagrama?
1 000 znaków. Dokumentacja Meta punktu końcowego tworzenia mediów opisuje parametr jako "Alternative text, up to 1000 character, for an image", i to jedyny limit tekstu alternatywnego opublikowany w dokumentacji dla deweloperów.
Czy API Instagrama obsługuje alt_text w Reels?
Nie. Dokumentacja Meta mówi wprost, że "Reels and stories are not supported" dla pola alt_text, zarówno w opisie parametru, jak i w informacji o wprowadzeniu funkcji w przewodniku po publikowaniu treści.
Czy można ustawić tekst alternatywny dla każdego slajdu karuzeli na Instagramie?
Tak, w każdym kontenerze podrzędnym. Opis parametru obejmuje "image media in a carousel", więc alt_text przekazujesz razem z is_carousel_item=true przy tworzeniu każdego obrazu, zanim złożysz nadrzędny kontener CAROUSEL.
Czy limit tekstu alternatywnego w aplikacji Instagram jest taki sam jak w API?
Dokumentacja Meta dla deweloperów nie podaje limitu znaków dla pola tekstu alternatywnego w aplikacji, więc nie da się porównać tych wartości na podstawie wiarygodnego źródła. Limit 1 000 znaków dotyczy parametru API alt_text.
Kiedy Instagram dodał alt_text do API publikacji?
24 marca 2025 roku. Przewodnik po publikowaniu treści podaje tę datę i ogranicza funkcję do postów z obrazami w punkcie końcowym /<INSTAGRAM_PROFESSIONAL_ACCOUNT_ID>/media.
Czy alt_text wlicza się do limitu podpisu na Instagramie?
Nie. To osobne parametry z osobnymi limitami w tym samym kontenerze: caption pozwala na 2 200 znaków, maksymalnie 30 hashtagów i 20 oznaczeń @, a alt_text na 1 000 znaków bez udokumentowanych zasad szczegółowych.
Czy można dodać alt_text do samodzielnego wideo przez API?
Wideo nie ma na liście kontenerów przyjmujących alt_text. Opis parametru ogranicza pole do "for an image", a ten punkt końcowy publikuje samodzielne wideo przez kontener REELS, jeden z dwóch typów wykluczonych w dokumentacji z nazwy.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Na którym etapie publikacji ustawia się alt_text?
Parametr alt_text przekazujesz przy tworzeniu kontenera w początkowym wywołaniu POST do /<IG_ID>/media, a nie na etapie publikacji. Wywołanie media_publish przyjmuje tylko creation_id, więc gdy kontener powstanie bez tego pola, nie ma drugiej szansy.
Co się stanie, jeśli mimo to wyślesz alt_text w kontenerze Reels lub Stories?
Nic użytecznego, bo punkt końcowy nie dokumentuje tego pola dla tych typów kontenerów. Dokumentacja Meta nie opisuje częściowej obsługi, przycinania ani przeniesienia tekstu do podpisu.
Czy pole alt_text ma zasady szczegółowe, tak jak pole podpisu?
Nie. Parametr podpisu ma obok limitu znaków udokumentowany limit 30 hashtagów i 20 oznaczeń @, a opis alt_text nie wymienia niczego takiego, tylko limit 1 000 znaków i ograniczenie do obrazów.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Dlaczego dzienny limit postów na Instagramie to w dokumentacji Mety 100 i 50
Instagram nie podaje dziennego limitu postów dla aplikacji. Dokumentacja API Mety mówi raz o 100 postach na 24 godziny, a dwa razy o 50. Sprawdź, co obowiązuje.


Co liczą interakcje z treściami na Instagramie, a co odejmują
Interakcje z treściami na Instagramie w praktyce: metryka Interakcje, pole API total_interactions, powody spadku liczby i to, kiedy wliczane są reklamy.


Co zwraca endpoint content_publishing_limit na Instagramie
Endpoint content_publishing_limit na Instagramie zwraca quota_usage oraz blok config z wartościami quota_total 50 i quota_duration 86400 sekund.
Powiązane artykuły


Limit podpisu na Instagramie, który naprawdę egzekwuje API Meta
Meta ustala limit podpisu na Instagramie na 2 200 znaków, 30 hashtagów i 20 oznaczeń @, a za długi podpis zwraca kod 36004 z podkodem 2207010.


Jak odczytać status_code kontenera na Instagramie przed publikacją
Wszystkie wartości status_code kontenera na Instagramie opisane przez Metę, zalecana częstotliwość odpytywania, 24-godzinny termin i co zrobić przy ERROR.


Gdzie naprawdę zapisano limit znaków tekstu alternatywnego na LinkedInie
Limit tekstu alternatywnego na LinkedInie to 4 086 znaków w polu altText w API, a dla pola tekstu alternatywnego w aplikacji LinkedIn nie publikuje żadnego limitu.

