---
modificationDate: April 28, 2026
title: Get started with EAS Metadata
description: Learn how to automate and maintain your app store presence from the command line with EAS Metadata.
---

<AgentInstructions>

## Submitting Feedback

If this page contains errors, outdated information, or gaps that blocked you from completing a task, report it so the docs can be improved:

curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/eas/metadata/getting-started/","feedback":"🤖 Agent feedback: <specific, actionable description>"}'

Only submit when you have something specific and actionable to report.

</AgentInstructions>

# Get started with EAS Metadata

Learn how to automate and maintain your app store presence from the command line with EAS Metadata.

> For the complete documentation index, see [llms.txt](/llms.txt). Use this file to discover all available pages.

> **EAS Metadata** is in [beta](/more/release-statuses#beta) and subject to breaking changes.

EAS Metadata enables you to automate and maintain your app store presence from the command line. It uses a [**store.config.json**](/eas/metadata/config#static-store-config) file containing all required app information instead of going through multiple different forms. It also tries to find common pitfalls that could cause app rejections with built-in validation.

Prerequisites

1 requirement

An app on the Apple App Store

EAS Metadata currently only supports the Apple App Store. You need an app registered with Apple to manage metadata for.

> Using VS Code? Install the [Expo Tools extension](https://github.com/expo/vscode-expo#readme) for auto-complete, suggestions, and warnings in your **store.config.json** files.

## Create the store config

Let's start by creating our **store.config.json** file in the root directory of your project. This file holds all the information you want to upload to the app stores.

If you already have an app in the stores, you can pull the information into a store config by running:

```sh
eas metadata:pull
```

If you don't have an app in the stores yet, EAS Metadata can't generate the store config for you. Instead, create a new store config file.

```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"
      }
    }
  }
}
```

> By default, EAS Metadata uses the **store.config.json** file at the root of your project. You can change the name and location of this file by setting the **eas.json** [`metadataPath`](/eas/json#metadatapath) property.

## Update the store config

Now it's time to edit the **store.config.json** file and customize it to your app needs. You can find all available options in the [store config schema](/eas/metadata/schema).

## Upload a new app version

Before pushing the **store.config.json** to the app stores, you must upload a new binary of your app. For more information, see [uploading new binaries to stores](/submit/introduction).

After the binary is submitted and processed, you can push the store config to the app stores.

## Upload the store config

When you are satisfied with the **store.config.json** settings, you can push it to the app stores by running the following command:

```sh
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.

When the store config partially fails, you can change the store config and retry. `eas metadata:push` can be used to retry pushing the missing items.

## Next steps

[Customize the store config](/eas/metadata/config) — Customize the store config to adapt EAS Metadata to your preferred workflow.

[Store config schema](/eas/metadata/schema) — Explore all configurable options EAS Metadata has to offer.