Devoria
Missing Metadata App Store Connect : débloquer un abonnement
Par Mehdi Azizi
Publié le , 9 min
Missing Metadata : il manque un champ obligatoire. Vérifie langue, prix, durée, pays, capture de revue et contrat payant, puis joins l'abonnement à une version.
Missing Metadata, ou « Métadonnées manquantes » dans App Store Connect en français, veut dire qu'il manque au moins une information obligatoire à ton abonnement ou à ton achat intégré. Vérifie dans l'ordre la langue, le prix, la durée, les pays, la capture de revue et le contrat des apps payantes. Tant que le produit reste dans cet état, tu ne peux pas l'envoyer en revue, et ton app ne peut pas le charger. Le premier abonnement doit en plus partir avec une version de l'app.
J'ai eu ce statut en juillet 2026 sur TradaZen, mon simulateur de trading. Le nouvel abonnement hebdomadaire avait sa durée, son prix, son groupe et deux langues. Il restait pourtant en « Métadonnées manquantes ». La seule pièce absente était la capture de revue. Voici les causes à vérifier, les états d'un produit avec ce qui débloque chacun, puis le lien avec RevenueCat.
Que veut dire Missing Metadata ?
Jusqu'à cette année, l'aide d'Apple définissait ce statut ainsi : le produit est créé, mais tu n'as pas encore envoyé de capture d'écran ou terminé ses métadonnées. Le statut ne dit jamais quel champ manque. C'est tout le problème : il faut chercher.
Attention, le libellé a changé en juillet 2026. Les notes de version d'App Store Connect annoncent au 15 juillet un nouveau mode d'envoi : chaque achat intégré se soumet depuis sa propre page, avec Add for Review. La page des statuts ne liste plus « Missing Metadata ». Elle commence par « Prepare for Submission » et précise : si ton achat intégré manque de métadonnées obligatoires, complète-les avant de l'ajouter à une soumission. La documentation de RevenueCat le confirme : avant la revue, un nouveau produit apparaît en « Prepare for Submission », même s'il lui manque des métadonnées.
L'API App Store Connect, elle, renvoie toujours MISSING_METADATA puis READY_TO_SUBMIT. Les outils qui s'appuient dessus affichent donc encore ces mots. Quel que soit le libellé, le diagnostic est le même : un champ obligatoire est vide.
Les causes à vérifier, dans l'ordre
Je les vérifie dans cet ordre, de la page du produit jusqu'au compte.
| Cause | Où corriger |
|---|---|
| Nom ou description vide | Page du produit |
| Groupe sans nom affiché | Page du groupe |
| Prix ou durée manquants | Page du produit |
| Aucun pays disponible | Availability |
| Capture de revue absente | Review Information |
| Contrat payant inactif | Business |
| Premier abonnement seul | Soumission |
1. La langue du produit. D'après la fiche des informations d'un achat intégré, le nom affiché et la description sont obligatoires dans au moins une langue. Le nom fait de 2 à 30 caractères, la description 45 au plus. Un produit sans langue ne peut pas partir.
2. La langue du groupe. Le groupe d'abonnements a aussi un nom affiché, que tes abonnés voient quand ils gèrent leurs abonnements sur l'iPhone. Il s'ajoute sur la page du groupe, rubrique Display Name and Description, comme l'explique la page d'Apple sur les abonnements. Le champ n'a pas l'air obligatoire. Pourtant, un développeur raconte sur les forums d'Apple que tous les abonnements de son groupe restaient bloqués tant qu'il était vide. Le statut s'affiche sur l'abonnement, pas sur le groupe, d'où la confusion.
3. Le prix et la durée. Un abonnement demande une durée, d'une semaine à un an, et un prix. La note technique TN3186 commence par là quand un produit ne se charge pas : vérifier son identifiant, son prix et ses langues. Retiens aussi que la durée ne se modifie plus après l'envoi en revue.
4. La disponibilité. Choisis au moins un pays ou une région dans Availability. Apple précise que, sans disponibilité, le statut « Approved » ne peut pas apparaître.
5. La capture de revue. C'est mon cas sur TradaZen, et une cause qui revient souvent sur les forums. La capture « App Review Screenshot » montre l'achat tel qu'il apparaît dans l'app, en général ton paywall. Elle sert uniquement au relecteur et n'est jamais affichée sur l'App Store. Elle suit les formats de tes captures App Store. Une fois envoyée, tu peux la remplacer, pas la supprimer.
Ne la confonds pas avec l'image promotionnelle de 1024 x 1024 pixels. Celle-là ne sert que si tu mets l'achat en avant sur ta fiche ou si tu crées une offre de reconquête, et elle a ses propres règles. Je l'ai appris avec un refus sur l'image promotionnelle d'un abonnement.
6. Le contrat des apps payantes. Pour proposer des achats intégrés, le titulaire du compte doit signer le Paid Apps Agreement dans Business, puis renseigner sa banque et sa fiscalité. Ce n'est pas un champ du produit, mais tout en dépend. Apple écrit que tu ne peux pas créer de nouvel achat intégré tant que tu n'as pas accepté la dernière version du contrat. Sa page sur la préparation des achats pour la revue ajoute que les achats payants ne fonctionnent pas en revue tant que ce contrat n'est pas actif. Dans Business, le contrat, le compte bancaire et les formulaires fiscaux doivent tous être actifs. Ces étapes sont détaillées dans le guide du compte développeur Apple.
7. Le premier abonnement envoyé seul. Ce n'est pas une métadonnée manquante. C'est pourtant la raison la plus courante d'un produit complet qui ne part jamais en revue. Je la détaille plus bas.
Les états d'un produit et ce qui débloque chacun
Voici la check-list que je garde sous les yeux. La première colonne donne l'état renvoyé par l'API, la deuxième le libellé de l'aide d'Apple depuis juillet 2026.
| État (API) | Libellé actuel | Ce qui débloque |
|---|---|---|
| MISSING_METADATA | Prepare for Submission | Remplir les champs |
| READY_TO_SUBMIT | Prepare for Submission | Add for Review |
| Pas d'équivalent | Ready for Review | Submit for Review |
| WAITING_FOR_REVIEW | Waiting for Review | Attendre Apple |
| IN_REVIEW | In Review | Attendre Apple |
| APPROVED | Approved | Pays et app validée |
| REJECTED | Rejected | Corriger, Update Review |
En détail :
- Missing Metadata vers Ready to Submit. Remplis les champs des causes 1 à 5, enregistre, recharge la page. En français, l'écran que j'avais en juillet affichait « Métadonnées manquantes », et l'état suivant s'appelait « Prêt à soumettre ».
- Ready to Submit vers Ready for Review. Sur la page de l'abonnement, clique sur Add for Review et ajoute-le à une soumission existante ou à une nouvelle. La procédure d'envoi d'un achat intégré te fait choisir la plateforme, la version de l'app et, si besoin, le groupe. Dès ce moment, seuls le nom de référence, le prix et la disponibilité restent modifiables.
- Ready for Review vers Waiting for Review. Vérifie que la version de l'app et le groupe sont dans la même soumission, puis clique sur Submit for Review.
- Waiting for Review vers Approved. Rien à faire, sauf garder ton paywall en état de marche. Si l'achat passe en « Accepted » et pas en « Approved », un autre élément de la même soumission a été refusé : Apple n'approuve rien tant que tout n'est pas accepté.
- Rejected. Le motif apparaît dans les messages de la soumission. Corrige l'élément, clique sur Update Review, puis renvoie la soumission.
Le premier abonnement part avec une version de l'app
La règle est dans l'aide d'Apple : le premier abonnement, comme le premier achat de chaque type, doit être soumis avec une nouvelle version de l'app. Un nouveau groupe part avec au moins un de ses abonnements. Une fois ce premier élément approuvé, tu peux soumettre les suivants du même type sans nouvelle version, tant que l'app a une version approuvée.
C'est ce qui s'est passé sur TradaZen. La version de juillet est partie avec l'annuel et le mensuel. L'hebdomadaire, encore en « Métadonnées manquantes », est resté hors de la soumission. Une fois l'app approuvée, il pouvait partir seul, sans nouveau build.
Si tu envoies l'app sans son abonnement, il faudra une nouvelle version pour le faire valider. Le guide sur le délai de validation App Store montre ce que ce cycle de plus coûte en jours.
Le lien avec RevenueCat : l'offre vide
RevenueCat ne vend rien lui‑même. Le SDK lit tes identifiants de produits sur ses serveurs, puis demande les produits à l'App Store, depuis l'iPhone. Si l'App Store ne les renvoie pas, l'offre arrive vide et ton paywall n'a rien à afficher. Les journaux du SDK affichent alors : « There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store. »
D'après RevenueCat, un produit aux métadonnées complètes se charge en sandbox avant même la revue. Un produit incomplet, non. Les autres pistes données par RevenueCat et Apple :
- le contrat des apps payantes et la banque, qui peuvent mettre jusqu'à 24 heures à se propager selon RevenueCat ;
- une modification du produit, qui peut mettre jusqu'à une heure à arriver en sandbox selon Apple ;
- un identifiant de produit différent entre App Store Connect, RevenueCat et ton code.
Sur TradaZen, le code masque la carte d'un abonnement dont le produit n'est pas renvoyé, sans casser le paywall. En octobre 2026, j'ai vu un paywall sans offre pour une autre raison : l'offre lue depuis le cache du SDK était vide. Depuis, si l'offre est vide, le code de l'app demande les produits directement à StoreKit, et propose de réessayer si le store ne répond pas.
Un paywall sans offre ne doit jamais être une impasse, ni pour l'utilisateur, ni pour le relecteur, qui doit pouvoir acheter. Le montage complet est dans mon guide RevenueCat pour un abonnement iOS, et les pièges d'affichage dans les erreurs de paywall. Une fois le produit prêt, vérifie aussi que ton paywall respecte la guideline 3.1.2.
Brancher ton abonnement sans y passer la semaine
Le Kit iOS part du code de départ de mes apps : onboarding, paywall et abonnements sont déjà codés, et sa troisième étape, « brancher l'argent », te guide pour les régler. Toute la chaîne, des produits App Store Connect à la vérification de l'achat, est décrite sur la page abonnement in-app iOS.
Si tu prépares ta première sortie, fais ton diagnostic gratuit : il remet les étapes dans l'ordre et t'envoie ma checklist anti-refus Apple. Si ton abonnement reste bloqué malgré tout ça, réserve une heure avec moi : on ouvre ton App Store Connect ensemble et on cherche le champ vide.
Questions fréquentes
Pourquoi mon abonnement reste en Missing Metadata alors que tout est rempli ?
Vérifie d'abord la capture de revue, puis le nom affiché du groupe d'abonnements, qui n'a pas l'air obligatoire. Contrôle ensuite le prix, la durée, au moins un pays, et le contrat des apps payantes dans Business. Après chaque correction, enregistre et recharge la page avant de conclure.
Faut-il une capture d'écran pour un abonnement ?
Oui, la capture de revue, appelée App Review Screenshot. Elle montre l'achat dans l'app, en général le paywall, et sert seulement au relecteur. Elle ne s'affiche pas sur l'App Store. Ne la confonds pas avec l'image promotionnelle de 1024 x 1024 pixels, utile seulement pour mettre l'achat en avant ou pour une offre de reconquête.
Peut-on soumettre un abonnement sans nouvelle version de l'app ?
Pas le premier. Le premier abonnement et son groupe partent avec une nouvelle version de l'app. Une fois ce premier abonnement approuvé, les suivants peuvent partir seuls, tant que l'app a une version approuvée.
Que veut dire Prepare for Submission pour un achat intégré ?
C'est le libellé de l'aide d'Apple depuis juillet 2026 pour un produit pas encore ajouté à une soumission. Il s'affiche même s'il manque des métadonnées. L'API App Store Connect distingue encore les deux cas, avec MISSING_METADATA et READY_TO_SUBMIT.
Pourquoi RevenueCat renvoie-t-il une offre vide ?
Parce que l'App Store n'a renvoyé aucun produit à l'iPhone. Les causes les plus courantes : métadonnées incomplètes, contrat des apps payantes inactif, identifiant de produit différent, ou modification récente pas encore propagée. Ton paywall doit gérer ce cas sans bloquer l'utilisateur.
