Missing Metadata v App Store Connect: oprava předplatného

Missing Metadata v App Store Connect znamená, že tvému předplatnému nebo nákupu v aplikaci chybí aspoň jeden povinný údaj. Zkontroluj postupně jazyk, cenu, délku, země, snímek pro revizi a smlouvu pro placené aplikace. Dokud produkt zůstává v tomhle stavu, nemůžeš ho poslat na revizi a tvoje aplikace ho nedokáže načíst. První předplatné navíc musí odejít spolu s verzí aplikace.

Tenhle stav jsem měl v červenci 2026 u TradaZen, mého simulátoru tradingu. Nové týdenní předplatné mělo délku, cenu, skupinu i dva jazyky. A přesto zůstávalo v Missing Metadata. Jediné, co chybělo, byl snímek pro revizi. Tady najdeš příčiny, které je potřeba zkontrolovat, stavy produktu a co každý z nich odblokuje, a nakonec souvislost s RevenueCat.

Co znamená Missing Metadata?

Až do letoška definovala Apple nápověda tenhle stav takto: produkt je vytvořený, ale ještě jsi nenahrál snímek obrazovky nebo nedokončil jeho metadata. Stav nikdy neřekne, které pole chybí. V tom je celý problém: musíš hledat.

Pozor, v červenci 2026 se označení změnilo. Poznámky k vydání App Store Connect oznamují k 15. červenci nový způsob odesílání: každý nákup v aplikaci se odesílá ze své vlastní stránky přes Add for Review. Stránka se stavy už „Missing Metadata“ neuvádí. Začíná stavem „Prepare for Submission“ a upřesňuje: pokud tvému nákupu v aplikaci chybí povinná metadata, doplň je, než ho přidáš do odeslání. Dokumentace RevenueCat to potvrzuje: před revizí se nový produkt zobrazuje jako „Prepare for Submission“, i když mu chybí metadata.

API App Store Connect ale pořád vrací MISSING_METADATA a pak READY_TO_SUBMIT. Nástroje, které na něm stojí, proto tyhle výrazy zobrazují dál. Ať je označení jakékoli, diagnóza je stejná: nějaké povinné pole je prázdné.

Příčiny ke kontrole, popořadě

Kontroluju je v tomhle pořadí, od stránky produktu až po účet.

Příčina	Kde opravit
Prázdný název nebo popis	Stránka produktu
Skupina bez zobrazeného názvu	Stránka skupiny
Chybí cena nebo délka	Stránka produktu
Žádná dostupná země	Availability
Chybí snímek pro revizi	Review Information
Neaktivní placená smlouva	Business
První předplatné samotné	Odeslání

1. Jazyk produktu. Podle stránky s informacemi o nákupu v aplikaci jsou zobrazený název a popis povinné aspoň v jednom jazyce. Název má 2 až 30 znaků, popis nejvýš 45. Produkt bez jazyka odeslat nejde.

2. Jazyk skupiny. Skupina předplatných má taky zobrazený název, který tví předplatitelé vidí, když spravují předplatná na iPhonu. Přidává se na stránce skupiny v sekci Display Name and Description, jak vysvětluje stránka Apple o předplatných. Pole nevypadá povinně. Jeden vývojář ale na fórech Apple popisuje, že všechna předplatná v jeho skupině zůstávala zablokovaná, dokud bylo prázdné. Stav se zobrazuje u předplatného, ne u skupiny, a odtud ten zmatek.

3. Cena a délka. Předplatné vyžaduje délku, od jednoho týdne do jednoho roku, a cenu. Technická poznámka TN3186 začíná právě tímhle, když se produkt nenačítá: zkontrolovat jeho identifikátor, cenu a jazyky. Pamatuj si taky, že délku po odeslání na revizi už nezměníš.

4. Dostupnost. V Availability vyber aspoň jednu zemi nebo region. Apple upřesňuje, že bez dostupnosti se stav „Approved“ nemůže objevit.

5. Snímek pro revizi. To byl můj případ u TradaZen a na fórech se tahle příčina objevuje často. Snímek „App Review Screenshot“ ukazuje nákup tak, jak vypadá v aplikaci, většinou tvůj paywall. Slouží jen recenzentovi a na App Store se nikdy nezobrazí. Řídí se formáty tvých snímků pro App Store. Jakmile ho nahraješ, můžeš ho nahradit, ale ne smazat.

Nepleť si ho s propagačním obrázkem 1024 x 1024 pixelů. Ten se hodí jen tehdy, když nákup zvýrazňuješ na své stránce v obchodě nebo vytváříš nabídku pro návrat zákazníků, a má vlastní pravidla. Naučil jsem se to po zamítnutí kvůli propagačnímu obrázku předplatného.

6. Smlouva pro placené aplikace. Aby mohl nabízet nákupy v aplikaci, musí držitel účtu podepsat Paid Apps Agreement v Business a pak vyplnit bankovní a daňové údaje. Není to pole produktu, ale všechno na tom závisí. Apple píše, že nový nákup v aplikaci nevytvoříš, dokud nepřijmeš poslední verzi smlouvy. Jeho stránka o přípravě nákupů na revizi dodává, že placené nákupy při revizi nefungují, dokud smlouva není aktivní. V Business musí být smlouva, bankovní účet i daňové formuláře aktivní. Tyhle kroky podrobně popisuje průvodce vývojářským účtem Apple.

7. První předplatné odeslané samotné. Nejde o chybějící metadata. Přesto je to nejčastější důvod, proč kompletní produkt nikdy neodejde na revizi. Rozeberu to níž.

Stavy produktu a co každý z nich odblokuje

Tohle je checklist, který mám pořád na očích. První sloupec ukazuje stav vrácený API, druhý označení v nápovědě Apple od července 2026.

Stav (API)	Aktuální označení	Co odblokuje
MISSING_METADATA	Prepare for Submission	Vyplnit pole
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Bez ekvivalentu	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Čekat na Apple
IN_REVIEW	In Review	Čekat na Apple
APPROVED	Approved	Země a schválená aplikace
REJECTED	Rejected	Opravit, Update Review

Podrobně:

• Z Missing Metadata do Ready to Submit. Vyplň pole z příčin 1 až 5, ulož a obnov stránku. Obrazovka, kterou jsem měl v červenci, ukazovala Missing Metadata a další stav se jmenoval Ready to Submit.
• Z Ready to Submit do Ready for Review. Na stránce předplatného klikni na Add for Review a přidej ho do existujícího nebo nového odeslání. Postup odeslání nákupu v aplikaci tě nechá vybrat platformu, verzi aplikace a případně skupinu. Od té chvíle jdou upravit už jen referenční název, cena a dostupnost.
• Z Ready for Review do Waiting for Review. Zkontroluj, že verze aplikace a skupina jsou ve stejném odeslání, a klikni na Submit for Review.
• Z Waiting for Review do Approved. Nic nedělej, jen udržuj paywall funkční. Pokud nákup přejde do „Accepted“ a ne do „Approved“, byla zamítnuta jiná položka ze stejného odeslání: Apple nic neschválí, dokud není přijato všechno.
• Rejected. Důvod najdeš ve zprávách k odeslání. Oprav položku, klikni na Update Review a odešli to znovu.

První předplatné odchází s verzí aplikace

Pravidlo stojí v nápovědě Apple: první předplatné, stejně jako první nákup každého typu, se musí odeslat s novou verzí aplikace. Nová skupina odchází aspoň s jedním svým předplatným. Jakmile je tahle první položka schválená, můžeš další stejného typu odesílat bez nové verze, pokud má aplikace schválenou verzi.

Přesně to se stalo u TradaZen. Červencová verze odešla s ročním a měsíčním předplatným. Týdenní, pořád v Missing Metadata, zůstalo mimo odeslání. Po schválení aplikace mohlo odejít samo, bez nového buildu.

Když pošleš aplikaci bez jejího předplatného, budeš na jeho schválení potřebovat novou verzi. Průvodce dobou schválení na App Store ukazuje, kolik dní tenhle cyklus navíc stojí.

Souvislost s RevenueCat: prázdná nabídka

RevenueCat sám nic neprodává. SDK si přečte identifikátory tvých produktů z jeho serverů a pak si produkty z iPhonu vyžádá od App Store. Když je App Store nevrátí, přijde nabídka prázdná a tvůj paywall nemá co zobrazit. Logy SDK pak vypíšou: „There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.“

Podle RevenueCat se produkt s kompletními metadaty načte v sandboxu ještě před revizí. Nekompletní produkt ne. Další stopy, které uvádí RevenueCat a Apple:

• smlouva pro placené aplikace a banka, jejichž propagace může podle RevenueCat trvat až 24 hodin;
• úprava produktu, která se podle Apple může do sandboxu dostat až za hodinu;
• jiný identifikátor produktu v App Store Connect, v RevenueCat a ve tvém kódu.

U TradaZen kód skryje kartu předplatného, jehož produkt se nevrátí, a paywall nerozbije. V říjnu 2026 jsem viděl paywall bez nabídky z jiného důvodu: nabídka načtená z cache SDK byla prázdná. Od té doby, když je nabídka prázdná, si kód aplikace vyžádá produkty přímo od StoreKit a nabídne opakování, pokud obchod neodpovídá.

Paywall bez nabídky nikdy nesmí být slepá ulička, ani pro uživatele, ani pro recenzenta, který musí mít možnost nakoupit. Celé zapojení je v mém průvodci RevenueCat pro předplatné na iOS a pasti při zobrazování v chybách na paywallu. Jakmile je produkt připravený, ověř taky, že tvůj paywall splňuje guideline 3.1.2.

Zapoj předplatné, aniž bys nad tím strávil celý týden

iOS & Android Kit vychází z výchozího kódu mých aplikací: onboarding, paywall a předplatná jsou už naprogramované a jeho třetí krok, „zapojit peníze“, tě provede jejich nastavením. Celý řetězec, od produktů v App Store Connect až po ověření nákupu, je popsaný na stránce předplatné v aplikaci na iOS.

Pokud chystáš své první vydání, udělej si bezplatnou diagnostiku: seřadí ti kroky a pošle ti můj checklist proti zamítnutí od Apple. Pokud ti předplatné i přes to všechno zůstává zablokované, zarezervuj si se mnou hodinu: otevřeme spolu tvůj App Store Connect a najdeme to prázdné pole.

Časté dotazy

Proč moje předplatné zůstává v Missing Metadata, když je všechno vyplněné?

Nejdřív zkontroluj snímek pro revizi a pak zobrazený název skupiny předplatných, který nevypadá povinně. Potom ověř cenu, délku, aspoň jednu zemi a smlouvu pro placené aplikace v Business. Po každé opravě ulož a obnov stránku, než uděláš závěr.

Potřebuje předplatné snímek obrazovky?

Ano, snímek pro revizi, kterému se říká App Review Screenshot. Ukazuje nákup v aplikaci, většinou paywall, a slouží jen recenzentovi. Na App Store se nezobrazuje. Nepleť si ho s propagačním obrázkem 1024 x 1024 pixelů, který se hodí jen ke zvýraznění nákupu nebo pro nabídku pro návrat zákazníků.

Dá se předplatné odeslat bez nové verze aplikace?

To první ne. První předplatné a jeho skupina odcházejí s novou verzí aplikace. Jakmile je tohle první předplatné schválené, další můžou odejít samostatně, pokud má aplikace schválenou verzi.

Co znamená Prepare for Submission u nákupu v aplikaci?

Je to označení v nápovědě Apple od července 2026 pro produkt, který ještě není přidaný do odeslání. Zobrazuje se, i když chybí metadata. API App Store Connect oba případy pořád rozlišuje pomocí MISSING_METADATA a READY_TO_SUBMIT.

Proč RevenueCat vrací prázdnou nabídku?

Protože App Store nevrátil iPhonu žádný produkt. Nejčastější příčiny: nekompletní metadata, neaktivní smlouva pro placené aplikace, jiný identifikátor produktu nebo nedávná úprava, která se ještě nepropagovala. Tvůj paywall musí tuhle situaci zvládnout, aniž by uživatele zablokoval.