# Missing Metadata w App Store Connect: odblokuj subskrypcję

> Missing Metadata oznacza brak wymaganego pola. Sprawdź język, cenę, okres, kraje, zrzut do recenzji i umowę Paid Apps, potem dołącz subskrypcję do wersji.

Oryginalna strona: [Missing Metadata w App Store Connect: odblokuj subskrypcję](https://devoria.fr/pl/blog/missing-metadata-app-store-connect-subskrypcja)
Autor: [Mehdi Azizi](https://devoria.fr/pl/mehdi-azizi)
Publikacja: 2026-11-04
Ostatnia aktualizacja treści: 2026-11-04


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](https://developer.apple.com/help/app-store-connect/release-notes/) 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](https://developer.apple.com/help/app-store-connect/reference/in-app-purchases-and-subscriptions/in-app-purchase-statuses/) 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](https://www.revenuecat.com/docs/offerings/troubleshooting-offerings) to potwierdza: przed recenzją nowy produkt ma status „Prepare for Submission”, nawet jeśli brakuje mu metadanych.

Natomiast [API App Store Connect](https://developer.apple.com/documentation/appstoreconnectapi/subscription/attributes-data.dictionary) 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](https://developer.apple.com/help/app-store-connect/reference/in-app-purchases-and-subscriptions/in-app-purchase-information/) 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](https://developer.apple.com/help/app-store-connect/manage-subscriptions/offer-auto-renewable-subscriptions/). To pole nie wygląda na obowiązkowe. Ale pewien developer opisuje na [forach Apple](https://developer.apple.com/forums/thread/778561), ż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](https://developer.apple.com/documentation/technotes/tn3186-troubleshooting-in-app-purchases-availability-in-the-sandbox) 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](https://devoria.fr/pl/blog/rozmiar-zrzutow-ekranu-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](https://devoria.fr/pl/blog/guideline-2-3-2-obraz-promocyjny-subskrypcji).

**6. Umowa dla płatnych aplikacji.** Żeby oferować zakupy w aplikacji, właściciel konta musi [podpisać Paid Apps Agreement](https://developer.apple.com/help/app-store-connect/manage-agreements/sign-and-update-agreements/) 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](https://developer.apple.com/help/app-review/before-submitting-for-review/configure-in-app-purchases/) 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](https://devoria.fr/pl/blog/konto-deweloperskie-apple-cena).

**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](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/submit-an-in-app-purchase/) 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](https://devoria.fr/pl/blog/czas-weryfikacji-app-store-ile-czekac) 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](https://devoria.fr/pl/blog/revenuecat-subskrypcja-in-app-ios), a pułapki wyświetlania w [błędach paywalla](https://devoria.fr/pl/blog/paywall-ios-bledy-blokujace-sprzedaz). Gdy produkt jest gotowy, sprawdź też, czy twój paywall spełnia [guideline 3.1.2](https://devoria.fr/pl/blog/guideline-3-1-2-odrzucenie-subskrypcja-paywall).

## Podłącz subskrypcję bez tracenia na to tygodnia

[iOS & Android Kit](https://devoria.fr/pl/kits/ios) 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](https://devoria.fr/pl/expertise/subskrypcja-w-aplikacji-ios).

Jeśli przygotowujesz swoje pierwsze wydanie, [zrób darmową diagnozę](https://devoria.fr/pl/diagnostic): uporządkuje kroki i wyśle ci moją checklistę przeciw odrzuceniom Apple. Jeśli mimo wszystko twoja subskrypcja dalej stoi, [zarezerwuj ze mną godzinę](https://devoria.fr/pl/coaching): 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.


## Twój projekt

[iOS & Android Kit](https://devoria.fr/pl/kits/ios): Stwórz swoją aplikację na iPhone'a i Androida z Claude Code: kod startowy moich aplikacji, droga aż do sklepów i wszystkie kity. 439 zł.

[Diagnoza: co dzieli cię od twojej aplikacji na iPhone'a](https://devoria.fr/pl/diagnostic): 7 pytań, 60 sekund: wiesz, co naprawdę blokuje publikację twojej aplikacji na iPhone'a, masz plan w 4 krokach i kit dopasowany do ciebie.