Missing Metadata App Store Connect: abonnement deblokkeren

Missing Metadata in App Store Connect betekent dat er minstens één verplicht gegeven ontbreekt bij je abonnement of in-app aankoop. Check in deze volgorde de taal, de prijs, de duur, de landen, de reviewscreenshot en het contract voor betaalde apps. Zolang het product in deze status blijft, kun je het niet ter review insturen en kan je app het niet laden. Het eerste abonnement moet bovendien samen met een versie van de app worden ingediend.

Ik kreeg deze status in juli 2026 bij TradaZen, mijn tradingsimulator. Het nieuwe weekabonnement had een duur, een prijs, een groep en twee talen. Toch bleef het op Missing Metadata staan. Het enige wat ontbrak was de reviewscreenshot. Hieronder de oorzaken om te checken, de statussen van een product met wat elke status deblokkeert, en daarna het verband met RevenueCat.

Wat betekent Missing Metadata?

Tot dit jaar omschreef Apple's helppagina deze status zo: het product is aangemaakt, maar je hebt nog geen screenshot geüpload of de metadata nog niet afgerond. De status zegt nooit welk veld ontbreekt. Dat is precies het probleem: je moet zelf zoeken.

Let op, de naam is in juli 2026 veranderd. De release notes van App Store Connect kondigen op 15 juli een nieuwe manier van indienen aan: elke in-app aankoop dien je in vanaf zijn eigen pagina, met Add for Review. De pagina met statussen noemt "Missing Metadata" niet meer. Ze begint met "Prepare for Submission" en zegt erbij: als je in-app aankoop verplichte metadata mist, vul die dan aan voordat je hem aan een submission toevoegt. De documentatie van RevenueCat bevestigt dat: vóór de review staat een nieuw product op "Prepare for Submission", ook als er metadata ontbreekt.

De App Store Connect API geeft nog steeds MISSING_METADATA en daarna READY_TO_SUBMIT terug. Tools die daarop draaien tonen die woorden dus nog. Welke naam je ook ziet, de diagnose is dezelfde: een verplicht veld is leeg.

De oorzaken om te checken, op volgorde

Ik check ze in deze volgorde, van de productpagina tot het account.

Oorzaak	Waar corrigeren
Naam of beschrijving leeg	Productpagina
Groep zonder weergavenaam	Groepspagina
Prijs of duur ontbreekt	Productpagina
Geen land beschikbaar	Availability
Reviewscreenshot ontbreekt	Review Information
Betaalcontract niet actief	Business
Eerste abonnement los ingediend	Submission

1. De taal van het product. Volgens de pagina met gegevens van een in-app aankoop zijn de weergavenaam en de beschrijving verplicht in minstens één taal. De naam is 2 tot 30 tekens, de beschrijving maximaal 45. Een product zonder taal kan niet worden ingediend.

2. De taal van de groep. De abonnementsgroep heeft ook een weergavenaam, die je abonnees zien als ze hun abonnementen beheren op hun iPhone. Je voegt die toe op de groepspagina, onder Display Name and Description, zoals Apple's pagina over abonnementen uitlegt. Het veld lijkt niet verplicht. Toch vertelt een developer op de Apple-forums dat alle abonnementen in zijn groep geblokkeerd bleven zolang het leeg was. De status verschijnt bij het abonnement, niet bij de groep, vandaar de verwarring.

3. De prijs en de duur. Een abonnement vraagt een duur, van een week tot een jaar, en een prijs. Technote TN3186 begint daar als een product niet laadt: check de identifier, de prijs en de talen. Onthoud ook dat je de duur na het insturen voor review niet meer kunt wijzigen.

4. De beschikbaarheid. Kies minstens één land of regio in Availability. Apple zegt erbij dat de status "Approved" zonder beschikbaarheid niet kan verschijnen.

5. De reviewscreenshot. Dat was mijn geval bij TradaZen, en een oorzaak die vaak terugkomt op de forums. De "App Review Screenshot" laat de aankoop zien zoals die in de app verschijnt, meestal je paywall. Hij is alleen voor de reviewer en wordt nooit op de App Store getoond. Hij volgt de formaten van je App Store-screenshots. Eenmaal geüpload kun je hem vervangen, maar niet verwijderen.

Verwar hem niet met de promotieafbeelding van 1024 x 1024 pixels. Die heb je alleen nodig als je de aankoop uitlicht op je productpagina of een win-back-aanbieding maakt, en ze heeft haar eigen regels. Dat leerde ik door een afwijzing op de promotieafbeelding van een abonnement.

6. Het contract voor betaalde apps. Om in-app aankopen aan te bieden moet de accounthouder de Paid Apps Agreement ondertekenen in Business, en daarna bank- en belastinggegevens invullen. Het is geen veld van het product, maar alles hangt ervan af. Apple schrijft dat je geen nieuwe in-app aankoop kunt aanmaken zolang je de nieuwste versie van het contract niet hebt geaccepteerd. Hun pagina over aankopen voorbereiden voor review voegt toe dat betaalde aankopen niet werken tijdens de review zolang dit contract niet actief is. In Business moeten het contract, de bankrekening en de belastingformulieren allemaal actief zijn. Die stappen staan uitgelegd in de gids over het Apple-developeraccount.

7. Het eerste abonnement los ingediend. Dit is geen ontbrekende metadata. Toch is het de meest voorkomende reden dat een compleet product nooit in review komt. Ik leg het hieronder uit.

De statussen van een product en wat elke status deblokkeert

Dit is de checklist die ik bij de hand houd. De eerste kolom geeft de status uit de API, de tweede de naam in Apple's helppagina sinds juli 2026.

Status (API)	Huidige naam	Wat deblokkeert
MISSING_METADATA	Prepare for Submission	Velden invullen
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Geen equivalent	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Wachten op Apple
IN_REVIEW	In Review	Wachten op Apple
APPROVED	Approved	Landen en goedgekeurde app
REJECTED	Rejected	Corrigeren, Update Review

In detail:

• Van Missing Metadata naar Ready to Submit. Vul de velden van oorzaak 1 tot 5 in, sla op en herlaad de pagina. Het scherm dat ik in juli zag toonde Missing Metadata, en de volgende status heette Ready to Submit.
• Van Ready to Submit naar Ready for Review. Klik op de pagina van het abonnement op Add for Review en voeg het toe aan een bestaande of nieuwe submission. De procedure voor het indienen van een in-app aankoop laat je het platform, de appversie en zo nodig de groep kiezen. Vanaf dat moment kun je alleen nog de referentienaam, de prijs en de beschikbaarheid aanpassen.
• Van Ready for Review naar Waiting for Review. Check dat de appversie en de groep in dezelfde submission zitten en klik op Submit for Review.
• Van Waiting for Review naar Approved. Niets te doen, behalve je paywall werkend houden. Gaat de aankoop naar "Accepted" en niet naar "Approved", dan is een ander onderdeel van dezelfde submission afgewezen: Apple keurt niets goed zolang niet alles geaccepteerd is.
• Rejected. De reden staat in de berichten van de submission. Corrigeer het onderdeel, klik op Update Review en stuur de submission opnieuw in.

Het eerste abonnement gaat mee met een appversie

De regel staat in Apple's helppagina: het eerste abonnement, net als de eerste aankoop van elk type, moet samen met een nieuwe versie van de app worden ingediend. Een nieuwe groep gaat mee met minstens één van zijn abonnementen. Zodra dat eerste onderdeel is goedgekeurd, kun je de volgende van hetzelfde type indienen zonder nieuwe versie, zolang de app een goedgekeurde versie heeft.

Zo ging het bij TradaZen. De versie van juli ging mee met het jaar- en het maandabonnement. Het weekabonnement, nog op Missing Metadata, bleef buiten de submission. Toen de app was goedgekeurd, kon het los worden ingediend, zonder nieuwe build.

Stuur je de app in zonder het abonnement, dan heb je een nieuwe versie nodig om het te laten goedkeuren. De gids over de reviewtijd van de App Store laat zien hoeveel dagen zo'n extra ronde kost.

Het verband met RevenueCat: de lege offering

RevenueCat verkoopt zelf niets. De SDK leest je product-identifiers van hun servers en vraagt de producten daarna vanaf de iPhone op bij de App Store. Geeft de App Store ze niet terug, dan komt de offering leeg binnen en heeft je paywall niets om te tonen. De SDK-logs tonen dan: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

Volgens RevenueCat laadt een product met complete metadata al in de sandbox vóór de review. Een incompleet product niet. De andere aanknopingspunten van RevenueCat en Apple:

• het contract voor betaalde apps en de bank, wat volgens RevenueCat tot 24 uur kan duren om door te komen;
• een wijziging aan het product, die er volgens Apple tot een uur over kan doen om in de sandbox te verschijnen;
• een product-identifier die verschilt tussen App Store Connect, RevenueCat en je code.

Bij TradaZen verbergt de code de kaart van een abonnement waarvan het product niet terugkomt, zonder de paywall te breken. In oktober 2026 zag ik een paywall zonder aanbod om een andere reden: de offering uit de cache van de SDK was leeg. Sindsdien vraagt de app bij een lege offering de producten direct op bij StoreKit, en biedt aan het opnieuw te proberen als de store niet reageert.

Een paywall zonder aanbod mag nooit een doodlopende weg zijn, niet voor de gebruiker en niet voor de reviewer, die moet kunnen kopen. De volledige opzet staat in mijn gids RevenueCat voor een iOS-abonnement, en de valkuilen bij de weergave in de paywall-fouten. Is het product klaar, check dan ook of je paywall voldoet aan guideline 3.1.2.

Je abonnement koppelen zonder er een week aan kwijt te zijn

De iOS & Android Kit vertrekt vanuit de startcode van mijn apps: onboarding, paywall en abonnementen zijn al gecodeerd, en de derde stap, "het geld koppelen", helpt je ze in te stellen. De hele keten, van de producten in App Store Connect tot de verificatie van de aankoop, staat beschreven op de pagina in-app abonnement iOS.

Bereid je je eerste release voor, doe dan je gratis diagnose: die zet de stappen op volgorde en stuurt je mijn checklist tegen afwijzingen door Apple. Blijft je abonnement ondanks dit alles geblokkeerd, boek een uur met mij: we openen samen je App Store Connect en zoeken het lege veld.

Veelgestelde vragen

Waarom blijft mijn abonnement op Missing Metadata staan terwijl alles is ingevuld?

Check eerst de reviewscreenshot, daarna de weergavenaam van de abonnementsgroep, die niet verplicht lijkt. Controleer vervolgens de prijs, de duur, minstens één land en het contract voor betaalde apps in Business. Sla na elke correctie op en herlaad de pagina voordat je conclusies trekt.

Heb je een screenshot nodig voor een abonnement?

Ja, de reviewscreenshot, de App Review Screenshot. Die laat de aankoop in de app zien, meestal de paywall, en is alleen voor de reviewer. Hij verschijnt niet op de App Store. Verwar hem niet met de promotieafbeelding van 1024 x 1024 pixels, die alleen nuttig is om de aankoop uit te lichten of voor een win-back-aanbieding.

Kun je een abonnement indienen zonder nieuwe appversie?

Het eerste niet. Het eerste abonnement en zijn groep gaan mee met een nieuwe versie van de app. Zodra dat eerste abonnement is goedgekeurd, kunnen de volgende los worden ingediend, zolang de app een goedgekeurde versie heeft.

Wat betekent Prepare for Submission bij een in-app aankoop?

Het is sinds juli 2026 de naam in Apple's helppagina voor een product dat nog niet aan een submission is toegevoegd. Hij verschijnt ook als er metadata ontbreekt. De App Store Connect API maakt nog onderscheid tussen beide gevallen, met MISSING_METADATA en READY_TO_SUBMIT.

Waarom geeft RevenueCat een lege offering terug?

Omdat de App Store geen enkel product naar de iPhone heeft teruggestuurd. De meest voorkomende oorzaken: incomplete metadata, een niet-actief contract voor betaalde apps, een afwijkende product-identifier of een recente wijziging die nog niet is doorgekomen. Je paywall moet dit geval afhandelen zonder de gebruiker te blokkeren.