Primary and secondary category
{
"configVersion": 0,
"apple": {
"categories": ["FINANCE", "NEWS"]
}
}
Edit this page
A reference of store config in EAS Metadata.
EAS Metadata is in beta and subject to breaking changes.
The store config in EAS Metadata contains information that otherwise would be provided manually through the app store dashboards. This document outlines the structure of the object in your store config.
If you use the VS Code Expo Tools extension, you get all this information through auto-complete, suggestions, and warnings in your editor.
An essential property in the store config object is the configVersion
property.
App stores might require more or change existing information structures to publish your app.
This property helps versioning changes that are not backward compatible.
EAS Metadata currently only supports the Apple App Store.
Property | Type | Description |
---|---|---|
|
enum: 0 | The EAS Metadata store configuration schema version. |
|
| All configurable properties for the App Store. |
|
| The app version to use when syncing all metadata defined in the store config. EAS Metadata selects the latest available version in the app stores by default. |
|
| The name of the person or entity that owns the exclusive rights to the app, preceded by the year the rights were obtained. (for example, "2008 Acme Inc.") |
| The App Store questionnaire to determine the app's age rating. | |
| App Store categories for the app. You can add primary, secondary, and possible subcategories. | |
|
| The localized App Store presence of your app. |
| The app release strategy for the selected version. | |
| All required information to review the app for the App Store review team, including contact info and credentials. (if applicable) |
Apple uses a complex questionnaire to determine the app's age rating. Parental controls on the App Store use this calculated age rating. EAS Metadata uses the least restrictive answer for each of these questions by default.
{
"configVersion": 0,
"apple": {
"advisory": {
"alcoholTobaccoOrDrugUseOrReferences": "NONE",
"contests": "NONE",
"gamblingSimulated": "NONE",
"horrorOrFearThemes": "NONE",
"matureOrSuggestiveThemes": "NONE",
"medicalOrTreatmentInformation": "NONE",
"profanityOrCrudeHumor": "NONE",
"sexualContentGraphicAndNudity": "NONE",
"sexualContentOrNudity": "NONE",
"violenceCartoonOrFantasy": "NONE",
"violenceRealistic": "NONE",
"violenceRealisticProlongedGraphicOrSadistic": "NONE",
"gambling": false,
"unrestrictedWebAccess": false,
"kidsAgeBand": null,
"seventeenPlus": false
}
}
}
Property | Type | Description |
---|---|---|
| Does the app contain alcohol, tobacco, or drug use or references? | |
| Does the app contain contests? | |
|
| Does your app contain gambling? |
| Does the app contain simulated gambling? | |
| Does the app contain horror or fear themes? | |
| When parents visit the Kids category on the App Store, they expect the apps they find will protect their children's data, provide only age-appropriate content, and require a parental gate to link out of the app, request permissions, or present purchasing opportunities. It's critical that no personally identifiable information or device information be transmitted to third parties, and that advertisements are human-reviewed for age appropriateness to be displayed. | |
| Does the app contain mature or suggestive themes? | |
| Does the app contain medical or treatment information? | |
| Does the app contain profanity or crude humor? | |
|
| If your app rates 12+ or lower, and you believe its content may not be suitable for children under 17, you can manually set the age rating to 17+. |
| Does the app contain graphic sexual content and nudity? | |
| Does the app contain sexual content or nudity? | |
|
| Does your app contain unrestricted web access, such as with an embedded browser? |
| Does the app contain cartoon or fantasy violence? | |
| Does the app contain realistic violence? | |
| Does the app contain prolonged graphic or sadistic realistic violence? |
Name | Description |
---|---|
| For apps that do not use the subject whatsoever. |
| For apps mentioning the subject or using the subject as a non-primary feature. |
| For apps using the subject as a primary feature. |
Name | Description |
---|---|
| For kids of 5 years old and below. |
| For kids between the age of 6 to 8 years. |
| For kids between the age of 9 to 11 years. |
The App Store helps users discover new apps by categorizing apps into categories, using primary, secondary, and possible subcategories.
{
"configVersion": 0,
"apple": {
"categories": ["FINANCE", "NEWS"]
}
}
{
"configVersion": 0,
"apple": {
"categories": [["GAMES", "GAMES_CARD", "GAMES_BOARD"], "ENTERTAINMENT"]
}
}
Name | Description |
---|---|
| Apps with content that is traditionally offered in printed form and which provide additional interactivity. |
| Apps that assist with running a business or provide a means to collaborate, edit, or share business-related content. |
| Apps that assist users with developing, maintaining, or sharing software. |
| Apps that provide an interactive learning experience on specific skills or subjects. |
| Interactive apps designed to entertain the user with audio, visual, or other content. |
| Apps that provide financial services or information to assist users with business or personal finances. |
| Apps that provide recommendations, instruction, or reviews related to preparing, consuming, or reviewing food or beverages. |
| Apps that provide single or multiplayer interactive experiences for entertainment purposes. This category can have up to 2 subcategories.
|
| Apps that provide tools or tips for creating, editing, or sharing visual content. |
| Apps related to healthy living, including stress management, fitness, and recreational activities. |
| Apps related to a general-interest subject matter or service. |
| Apps with journalistic content that is traditionally offered in printed form and which provide additional interactivity. |
| Apps focused on medical education, information, or health reference for patients or healthcare professionals. |
| Apps that are for discovering, listening, recording, performing, or composing music. |
| Apps that provide information to help a user get to a physical location. |
| Apps that provide information about current events and/or developments in areas of interest such as politics, entertainment, business, science, technology, and other areas. |
| Apps that assist in capturing, editing, managing, storing, or sharing photos and videos. |
| Apps that make a specific process or task more organized or efficient. |
| Apps that assist the user in accessing or retrieving general information. |
| Apps that provide a means to purchase goods or services. |
| Apps that connect people through text, voice, photo, or video. |
| Apps related to professional, amateur, collegiate, or recreational sporting activities. |
| Apps that provide extended visual functionality to messaging apps. This category can have up to 2 subcategories.
|
| Apps that assist the user with any aspect of travel, such as planning, purchasing, or tracking. |
| Apps that enable the user to solve a problem or complete a specific task. |
| Apps with specific weather-related information. |
The App Store is a global service used by many people in different languages. You can localize your App Store presence in multiple languages.
{
"configVersion": 0,
"apple": {
"info": {
"en-US": {
"title": "Awesome app",
"privacyPolicyUrl": "https://example.com/en/privacy"
}
}
}
}
{
"configVersion": 0,
"apple": {
"info": {
"en-US": {
"title": "App title",
"subtitle": "Subtitle for your app",
"description": "A longer description of what your app does",
"keywords": ["keyword", "other-keyword"],
"releaseNotes": "Bug fixes and improved stability",
"promoText": "Short tagline for your app",
"marketingUrl": "https://example.com/en",
"supportUrl": "https://example.com/en/help",
"privacyPolicyUrl": "https://example.com/en/privacy",
"privacyChoicesUrl": "https://example.com/en/privacy/choices"
}
}
}
}
Property | Type | Description |
---|---|---|
|
length: 2..30 | Name of the app in the store. This name should be similar to the installed app name. The name will be reviewed before it is made available on the App Store. |
|
length: 30 | Subtext for the app in the store. For example, "A Fun Game For Friends". The subtitle will be reviewed before it is made available on the App Store. |
|
length: 10..4000 | The main description of what the app does |
|
unique itemsmax length item: 100 | List of keywords to help users find the app in the App Store |
|
max length: 4000 | Changes since the last public version |
|
max length: 170 | The short tagline for the app |
|
max length: 255 | URL to the app marketing page |
|
max length: 255 | URL to the app support page |
|
| Privacy policy for Apple TV |
|
max length: 255 | URL that links to your privacy policy. A privacy policy is required for all apps. |
|
max length: 255 | URL where users can modify and delete the data collected from the app or decide how their data is used and shared. |
Language | Language Code |
---|---|
Arabic |
|
Catalan |
|
Chinese |
|
Croatian |
|
Czech |
|
Danish |
|
Dutch |
|
English |
|
Finnish |
|
French |
|
German |
|
Greek |
|
Hebrew |
|
Hindi |
|
Hungarian |
|
Indonesian |
|
Italian |
|
Japanese |
|
Korean |
|
Malay |
|
Norwegian |
|
Polish |
|
Portuguese |
|
Romanian |
|
Russian |
|
Slovak |
|
Spanish |
|
Swedish |
|
Thai |
|
Turkish |
|
Ukrainian |
|
Vietnamese |
|
There are multiple strategies to put the app in the hands of your users. You can release the app automatically after store approval or gradually release an update to your users.
{
"configVersion": 0,
"apple": {
"release": {
"automaticRelease": "2022-12-25T00:00:00+00:00"
}
}
}
Property | Type | Description |
---|---|---|
|
| If and how the app should automatically be released after approval from the App Store.
Apple does not guarantee that your app is available at the chosen scheduled release date. |
|
| Phased release for automatic updates lets you gradually release this update over a 7-day period to users who have turned on automatic updates. Keep in mind that this version will still be available to all users as a manual update from the App Store. You can pause the phased release for up to 30 days or release this update to all users at any time. |
Before publishing the app on the App Store, store approval is required. The App Store review team must have all the information to test your app, or you risk an app rejection.
{
"configVersion": 0,
"apple": {
"review": {
"firstName": "John",
"lastName": "Doe",
"email": "john@example.com",
"phone": "+1 123 456 7890"
}
}
}
{
"configVersion": 0,
"apple": {
"review": {
"firstName": "John",
"lastName": "Doe",
"email": "john@example.com",
"phone": "+1 123 456 7890",
"demoUsername": "john",
"demoPassword": "applereview",
"demoRequired": false,
"notes": "This is an example app primarily used for educational purposes."
}
}
}
Property | Type | Description |
---|---|---|
|
min length: 1 | The app contact's first name in case communication is needed with the App Store review team is needed. |
|
min length: 1 | The app contact's last name in case communication is needed with the App Store review team is needed. |
|
| Email contact address in case communication is needed with the App Store review team. |
|
| Contact phone number in case communication is needed with the App Store review team. Preface the phone number with "+" followed by the country code. (for example, +44 844 209 0611) |
|
| The user name to sign in to your app to review its features. |
|
| The password to sign in to your app to review its features. |
|
| A Boolean value indicates if sign-in information is required to review your app's features. If users sign in using social media, provide information for an account for review. Credentials must be valid and active for the duration of the review. |
|
length: 2..4000 | Additional information about your app that can help during the review process. Do not include demo account details in the notes. Use the |