Missing Metadata w App Store Connect: odblokuj subskrypcję

Missing Metadata w App Store Connect oznacza, że twojej subskrypcji albo zakupowi w aplikacji brakuje co najmniej jednej wymaganej informacji. Sprawdź po kolei język, cenę, okres, kraje, zrzut ekranu do recenzji i umowę dla płatnych aplikacji. Dopóki produkt ma ten status, nie wyślesz go do recenzji, a twoja aplikacja nie będzie mogła go załadować. Do tego pierwsza subskrypcja musi zostać wysłana razem z wersją aplikacji.

Miałem ten status w lipcu 2026 w TradaZen, moim symulatorze tradingu. Nowa subskrypcja tygodniowa miała okres, cenę, grupę i dwa języki. A mimo to wciąż wisiała w Missing Metadata. Jedyne, czego brakowało, to zrzut ekranu do recenzji. Poniżej znajdziesz przyczyny do sprawdzenia, stany produktu i to, co odblokowuje każdy z nich, a na końcu związek z RevenueCat.

Co oznacza Missing Metadata?

Do tego roku pomoc Apple definiowała ten status tak: produkt jest utworzony, ale nie wysłałeś jeszcze zrzutu ekranu albo nie uzupełniłeś jego metadanych. Status nigdy nie mówi, którego pola brakuje. I w tym cały problem: trzeba szukać.

Uwaga, w lipcu 2026 zmieniła się nazwa statusu. Informacje o wydaniu App Store Connect ogłaszają 15 lipca nowy sposób wysyłki: każdy zakup w aplikacji zgłaszasz z jego własnej strony, przyciskiem Add for Review. Strona ze statusami nie wymienia już „Missing Metadata”. Zaczyna się od „Prepare for Submission” i dodaje: jeśli twojemu zakupowi brakuje wymaganych metadanych, uzupełnij je, zanim dodasz go do zgłoszenia. Dokumentacja RevenueCat to potwierdza: przed recenzją nowy produkt ma status „Prepare for Submission”, nawet jeśli brakuje mu metadanych.

Natomiast API App Store Connect nadal zwraca MISSING_METADATA, a potem READY_TO_SUBMIT. Narzędzia, które z niego korzystają, wciąż pokazują te nazwy. Niezależnie od nazwy diagnoza jest ta sama: jakieś wymagane pole jest puste.

Przyczyny do sprawdzenia, po kolei

Sprawdzam je w tej kolejności, od strony produktu aż po konto.

Przyczyna	Gdzie poprawić
Pusta nazwa lub opis	Strona produktu
Grupa bez nazwy wyświetlanej	Strona grupy
Brak ceny lub okresu	Strona produktu
Żaden kraj niedostępny	Availability
Brak zrzutu do recenzji	Review Information
Nieaktywna umowa płatna	Business
Pierwsza subskrypcja wysłana sama	Zgłoszenie

1. Język produktu. Według opisu informacji o zakupie w aplikacji nazwa wyświetlana i opis są wymagane w co najmniej jednym języku. Nazwa ma od 2 do 30 znaków, opis maksymalnie 45. Produkt bez języka nie zostanie wysłany.

2. Język grupy. Grupa subskrypcji też ma nazwę wyświetlaną, którą twoi subskrybenci widzą, gdy zarządzają subskrypcjami na iPhonie. Dodajesz ją na stronie grupy, w sekcji Display Name and Description, jak wyjaśnia strona Apple o subskrypcjach. To pole nie wygląda na obowiązkowe. Ale pewien developer opisuje na forach Apple, że wszystkie subskrypcje w jego grupie były zablokowane, dopóki było puste. Status wyświetla się przy subskrypcji, a nie przy grupie, stąd zamieszanie.

3. Cena i okres. Subskrypcja wymaga okresu, od tygodnia do roku, oraz ceny. Nota techniczna TN3186 od tego zaczyna, gdy produkt się nie ładuje: sprawdź identyfikator, cenę i języki. Zapamiętaj też, że okresu nie da się już zmienić po wysłaniu do recenzji.

4. Dostępność. Wybierz co najmniej jeden kraj lub region w Availability. Apple zaznacza, że bez dostępności status „Approved” nie może się pojawić.

5. Zrzut ekranu do recenzji. To był mój przypadek w TradaZen i przyczyna, która często wraca na forach. Zrzut „App Review Screenshot” pokazuje zakup tak, jak wygląda w aplikacji, zwykle twój paywall. Służy wyłącznie recenzentowi i nigdy nie jest pokazywany w App Store. Ma te same formaty co twoje zrzuty ekranu do App Store. Po wysłaniu możesz go podmienić, ale nie usunąć.

Nie myl go z grafiką promocyjną 1024 x 1024 piksele. Ta przydaje się tylko wtedy, gdy promujesz zakup na swojej stronie w sklepie albo tworzysz ofertę odzyskania subskrybentów, i ma własne zasady. Przekonałem się o tym przy odrzuceniu grafiki promocyjnej subskrypcji.

6. Umowa dla płatnych aplikacji. Żeby oferować zakupy w aplikacji, właściciel konta musi podpisać Paid Apps Agreement w Business, a potem uzupełnić dane bankowe i podatkowe. To nie jest pole produktu, ale wszystko od tego zależy. Apple pisze, że nie możesz tworzyć nowych zakupów w aplikacji, dopóki nie zaakceptujesz najnowszej wersji umowy. Jego strona o przygotowaniu zakupów do recenzji dodaje, że płatne zakupy nie działają podczas recenzji, dopóki ta umowa nie jest aktywna. W Business umowa, konto bankowe i formularze podatkowe muszą być aktywne. Te kroki opisuję szczegółowo w poradniku o koncie developera Apple.

7. Pierwsza subskrypcja wysłana sama. To nie są brakujące metadane. A jednak to najczęstszy powód, dla którego kompletny produkt nigdy nie trafia do recenzji. Opisuję to niżej.

Stany produktu i co odblokowuje każdy z nich

Oto checklista, którą trzymam pod ręką. Pierwsza kolumna podaje stan zwracany przez API, druga nazwę z pomocy Apple od lipca 2026.

Stan (API)	Obecna nazwa	Co odblokowuje
MISSING_METADATA	Prepare for Submission	Uzupełnienie pól
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Brak odpowiednika	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Czekanie na Apple
IN_REVIEW	In Review	Czekanie na Apple
APPROVED	Approved	Kraje i zatwierdzona aplikacja
REJECTED	Rejected	Poprawka, Update Review

Szczegółowo:

• Z Missing Metadata do Ready to Submit. Uzupełnij pola z przyczyn od 1 do 5, zapisz, odśwież stronę. Ekran, który miałem w lipcu, pokazywał Missing Metadata, a kolejny stan nazywał się Ready to Submit.
• Z Ready to Submit do Ready for Review. Na stronie subskrypcji kliknij Add for Review i dodaj ją do istniejącego albo nowego zgłoszenia. Procedura wysyłki zakupu w aplikacji każe ci wybrać platformę, wersję aplikacji i w razie potrzeby grupę. Od tej chwili można edytować tylko nazwę referencyjną, cenę i dostępność.
• Z Ready for Review do Waiting for Review. Sprawdź, czy wersja aplikacji i grupa są w tym samym zgłoszeniu, potem kliknij Submit for Review.
• Z Waiting for Review do Approved. Nic nie musisz robić, poza utrzymaniem działającego paywalla. Jeśli zakup przejdzie w „Accepted”, a nie w „Approved”, to inny element tego samego zgłoszenia został odrzucony: Apple niczego nie zatwierdza, dopóki wszystko nie jest zaakceptowane.
• Rejected. Powód pojawia się w wiadomościach zgłoszenia. Popraw element, kliknij Update Review i wyślij zgłoszenie ponownie.

Pierwsza subskrypcja idzie razem z wersją aplikacji

Zasada jest w pomocy Apple: pierwsza subskrypcja, tak jak pierwszy zakup każdego typu, musi zostać zgłoszona z nową wersją aplikacji. Nowa grupa idzie z co najmniej jedną ze swoich subskrypcji. Gdy ten pierwszy element zostanie zatwierdzony, kolejne tego samego typu możesz zgłaszać bez nowej wersji, o ile aplikacja ma zatwierdzoną wersję.

Tak właśnie było w TradaZen. Lipcowa wersja poszła z roczną i miesięczną. Tygodniowa, wciąż w Missing Metadata, została poza zgłoszeniem. Po zatwierdzeniu aplikacji mogła pójść sama, bez nowego buildu.

Jeśli wyślesz aplikację bez jej subskrypcji, będziesz potrzebować nowej wersji, żeby ją zatwierdzić. Poradnik o czasie weryfikacji w App Store pokazuje, ile dni kosztuje taki dodatkowy cykl.

Związek z RevenueCat: pusta oferta

RevenueCat sam niczego nie sprzedaje. SDK odczytuje identyfikatory produktów z jego serwerów, a potem prosi App Store o produkty, z iPhone'a. Jeśli App Store ich nie zwróci, oferta przychodzi pusta, a twój paywall nie ma czego wyświetlić. Logi SDK pokazują wtedy: „There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.”

Według RevenueCat produkt z kompletnymi metadanymi ładuje się w sandboksie jeszcze przed recenzją. Niekompletny nie. Inne tropy podawane przez RevenueCat i Apple:

• umowa dla płatnych aplikacji i bank, których propagacja według RevenueCat może trwać do 24 godzin;
• zmiana produktu, która według Apple może dotrzeć do sandboksa nawet po godzinie;
• inny identyfikator produktu w App Store Connect, RevenueCat i twoim kodzie.

W TradaZen kod ukrywa kartę subskrypcji, której produkt nie został zwrócony, bez psucia paywalla. W październiku 2026 widziałem paywall bez oferty z innego powodu: oferta odczytana z cache SDK była pusta. Od tamtej pory, gdy oferta jest pusta, kod aplikacji prosi o produkty bezpośrednio StoreKit i proponuje ponowienie, jeśli sklep nie odpowiada.

Paywall bez oferty nigdy nie może być ślepą uliczką, ani dla użytkownika, ani dla recenzenta, który musi móc dokonać zakupu. Pełną konfigurację opisuję w poradniku RevenueCat dla subskrypcji iOS, a pułapki wyświetlania w błędach paywalla. Gdy produkt jest gotowy, sprawdź też, czy twój paywall spełnia guideline 3.1.2.

Podłącz subskrypcję bez tracenia na to tygodnia

iOS & Android Kit bazuje na kodzie startowym moich aplikacji: onboarding, paywall i subskrypcje są już zakodowane, a jego trzeci etap, „podłącz pieniądze”, prowadzi cię przez ich konfigurację. Cały łańcuch, od produktów w App Store Connect po weryfikację zakupu, jest opisany na stronie subskrypcja w aplikacji iOS.

Jeśli przygotowujesz swoje pierwsze wydanie, zrób darmową diagnozę: uporządkuje kroki i wyśle ci moją checklistę przeciw odrzuceniom Apple. Jeśli mimo wszystko twoja subskrypcja dalej stoi, zarezerwuj ze mną godzinę: otworzymy razem twoje App Store Connect i znajdziemy puste pole.

Najczęściej zadawane pytania

Dlaczego moja subskrypcja wisi w Missing Metadata, choć wszystko jest uzupełnione?

Najpierw sprawdź zrzut ekranu do recenzji, potem nazwę wyświetlaną grupy subskrypcji, która nie wygląda na obowiązkową. Następnie skontroluj cenę, okres, co najmniej jeden kraj i umowę dla płatnych aplikacji w Business. Po każdej poprawce zapisz i odśwież stronę, zanim wyciągniesz wnioski.

Czy subskrypcja potrzebuje zrzutu ekranu?

Tak, zrzutu do recenzji, czyli App Review Screenshot. Pokazuje zakup w aplikacji, zwykle paywall, i służy tylko recenzentowi. Nie wyświetla się w App Store. Nie myl go z grafiką promocyjną 1024 x 1024 piksele, przydatną tylko do promowania zakupu albo oferty odzyskania subskrybentów.

Czy można zgłosić subskrypcję bez nowej wersji aplikacji?

Pierwszej nie. Pierwsza subskrypcja i jej grupa idą z nową wersją aplikacji. Gdy ta pierwsza subskrypcja zostanie zatwierdzona, kolejne mogą iść same, o ile aplikacja ma zatwierdzoną wersję.

Co oznacza Prepare for Submission przy zakupie w aplikacji?

To nazwa z pomocy Apple od lipca 2026 dla produktu, który nie został jeszcze dodany do zgłoszenia. Wyświetla się nawet wtedy, gdy brakuje metadanych. API App Store Connect wciąż rozróżnia oba przypadki: MISSING_METADATA i READY_TO_SUBMIT.

Dlaczego RevenueCat zwraca pustą ofertę?

Bo App Store nie zwrócił iPhone'owi żadnego produktu. Najczęstsze przyczyny: niekompletne metadane, nieaktywna umowa dla płatnych aplikacji, inny identyfikator produktu albo niedawna zmiana, która jeszcze się nie rozpropagowała. Twój paywall musi obsłużyć ten przypadek bez blokowania użytkownika.