This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

App stores metadata

Edit page

A brief overview of how to use EAS Metadata to automate and maintain your app store presence.


When submitting your app to app stores, you need to provide metadata. This process is lengthy and is often about complex topics that don't apply to your app. After the information you provide gets reviewed and if there is any issue with it, you need to restart this process.

EAS Metadata enables you to automate and maintain this information from the command line instead of going through multiple forms in the app store dashboards. It can also instantly identify well-known app store restrictions that could trigger a rejection after a lengthy review queue. This guide shows how to use EAS Metadata to automate and maintain your app store presence.

Create a store config

EAS Metadata uses store.config.json file to hold all the information you want to upload to the app stores. This file is located at the root of your Expo project.

Create a new store.config.json file at the root of your project directory as shown in the example below:

store.config.json
{ "configVersion": 0, "apple": { "info": { "en-US": { "title": "Awesome App", "subtitle": "Your self-made awesome app", "description": "The most awesome app you have ever seen", "keywords": ["awesome", "app"], "marketingUrl": "https://example.com/en/promo", "supportUrl": "https://example.com/en/support", "privacyPolicyUrl": "https://example.com/en/privacy" } } } }

The above example file contains JSON schema. Replace the example values with your own. It is usually contains your app's title, subtitle , description, keywords, and marketingUrl and so on.

An important thing to remember from the above example is the configVersion property. It helps with versioning changes that are not backward compatible.

Upload the store config

After you have created the store.config.json file and added the necessary information related to your app, you can push the store config to the app stores by running the command:

Terminal
eas metadata:push

If EAS Metadata runs into any issues with your store config, it will warn you when running this command. When there are no errors, or you confirm to push it with possible issues, it will try to upload as much as possible.

You can also re-use this command when you modify the store.config.json file and want to push the latest changes to the app stores.

Next steps

EAS Metadata schema

A reference of store config in EAS Metadata.

Static and dynamic configurations with EAS Metadata

Learn about different ways to configure EAS Metadata.