Setting the file. One moment.
Subchapter 3.1
references/app-store-metadata.mdMarkdown14 KBView on GitHub
Manage App Store metadata and optimize for ASO using EAS Metadata.
EAS Metadata automates App Store presence management from the command line using a store.config.json file instead of manually filling forms in App Store Connect. It includes built-in validation to catch common rejection pitfalls.
Current Status: Preview, Apple App Store only.
If your app is already published, pull current metadata:
eas metadata:pullThis creates store.config.json with your current App Store configuration.
After editing your config, push changes:
eas metadata:pushImportant: You must submit a binary via eas submit before pushing metadata for new apps.
Create store.config.json at your project root:
{
"configVersion": 0,
"apple": {
"copyright": "2025 Your Company",
"categories": ["UTILITIES", "PRODUCTIVITY"],
"info": {
"en-US": {
"title": "App Name",
"subtitle": "Your compelling tagline",
"description": "Full app description...",
"keywords": ["keyword1", "keyword2", "keyword3"],
"releaseNotes": "What's new in this version...",
"promoText": "Limited time offer!",
"privacyPolicyUrl": "https://example.com/privacy",
"supportUrl": "https://example.com/support",
"marketingUrl": "https://example.com"
}
},
"advisory": {
"alcoholTobaccoOrDrugUseOrReferences": "NONE",
"gamblingSimulated": "NONE",
"medicalOrTreatmentInformation": "NONE",
"profanityOrCrudeHumor": "NONE",
"sexualContentGraphicAndNudity": "NONE",
"sexualContentOrNudity": "NONE",
"horrorOrFearThemes": "NONE",
"matureOrSuggestiveThemes": "NONE",
"violenceCartoonOrFantasy": "NONE",
"violenceRealistic": "NONE",
"violenceRealisticProlongedGraphicOrSadistic": "NONE",
"contests": "NONE",
"gambling": false,
"unrestrictedWebAccess": false,
"seventeenPlus": false
},
"release": {
"automaticRelease": true,
"phasedRelease": true
},
"review": {
"firstName": "John",
"lastName": "Doe",
"email": "review@example.com",
"phone": "+1 555-123-4567",
"notes": "Demo account: test@example.com / password123"
}
}
}The title is the most important ranking factor. Include your brand name and 1-2 strongest keywords.
{
"title": "Budgetly - Money Tracker"
}Best Practices:
The subtitle appears below your title in search results. Use it for your unique value proposition.
{
"subtitle": "Smart Expense & Budget Planner"
}Best Practices:
Hidden from users but crucial for discoverability. Use comma-separated keywords without spaces after commas.
{
"keywords": [
"finance,budget,expense,money,tracker,savings,bills,income,spending,wallet,personal,weekly,monthly"
]
}Best Practices:
The iOS description is NOT indexed for search but critical for conversion. Focus on convincing users to download.
{
"description": "Take control of your finances with Budgetly, the intuitive money management app trusted by over 1 million users.\n\nKEY FEATURES:\n• Smart budget tracking - Set limits and watch your progress\n• Expense categorization - Know exactly where your money goes\n• Bill reminders - Never miss a payment\n• Beautiful charts - Visualize your financial health\n• Bank sync - Connect 10,000+ institutions\n• Cloud backup - Your data, always safe\n\nWHY BUDGETLY?\nUnlike complex spreadsheets or basic calculators, Budgetly learns your spending habits and provides personalized insights. Our users save an average of $300/month within 3 months.\n\nPRIVACY FIRST\nYour financial data is encrypted end-to-end. We never sell your information.\n\nDownload Budgetly today and start your journey to financial freedom!"
}Best Practices:
Shown to existing users deciding whether to update.
{
"releaseNotes": "Version 2.5 brings exciting improvements:\n\n• NEW: Dark mode support\n• NEW: Widget for home screen\n• IMPROVED: 50% faster sync\n• FIXED: Notification timing issues\n\nLove Budgetly? Please leave a review!"
}Appears above description; can be updated without new binary. Great for time-sensitive promotions.
{
"promoText": "🎉 New Year Special: Premium features free for 30 days! Start 2025 with better finances."
}Primary category is most important for browsing and rankings.
{
"categories": ["FINANCE", "PRODUCTIVITY"]
}Available Categories:
Localize metadata for each target market. Keywords should be researched per locale—direct translations often miss regional search terms.
{
"info": {
"en-US": {
"title": "Budgetly - Money Tracker",
"subtitle": "Smart Expense Planner",
"keywords": ["budget,finance,money,expense,tracker"]
},
"es-ES": {
"title": "Budgetly - Control de Gastos",
"subtitle": "Planificador de Presupuesto",
"keywords": ["presupuesto,finanzas,dinero,gastos,ahorro"]
},
"ja": {
"title": "Budgetly - 家計簿アプリ",
"subtitle": "簡単支出管理",
"keywords": ["家計簿,支出,予算,節約,お金"]
},
"de-DE": {
"title": "Budgetly - Haushaltsbuch",
"subtitle": "Ausgaben Verwalten",
"keywords": ["budget,finanzen,geld,ausgaben,sparen"]
}
}
}Supported Locales:
ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US, es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it, ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk, sv, th, tr, uk, vi, zh-Hans, zh-Hant
Use JavaScript for dynamic values like copyright year or fetched translations.
// store.config.js
const baseConfig = require("./store.config.json");
const year = new Date().getFullYear();
module.exports = {
...baseConfig,
apple: {
...baseConfig.apple,
copyright: `${year} Your Company, Inc.`,
},
};// store.config.js
module.exports = async () => {
const baseConfig = require("./store.config.json");
// Fetch translations from CMS/localization service
const translations = await fetch(
"https://api.example.com/app-store-copy"
).then((r) => r.json());
return {
...baseConfig,
apple: {
...baseConfig.apple,
info: translations,
},
};
};// store.config.js
const baseConfig = require("./store.config.json");
const isProduction = process.env.EAS_BUILD_PROFILE === "production";
module.exports = {
...baseConfig,
apple: {
...baseConfig.apple,
info: {
"en-US": {
...baseConfig.apple.info["en-US"],
promoText: isProduction
? "Download now and get started!"
: "[BETA] Help us test new features!",
},
},
},
};Update eas.json to use JS config:
{
"cli": {
"metadataPath": "./store.config.js"
}
}Answer content questions honestly to get an appropriate age rating.
Content Descriptors:
NONE - Content not presentINFREQUENT_OR_MILD - Occasional mild contentFREQUENT_OR_INTENSE - Regular or strong content{
"advisory": {
"alcoholTobaccoOrDrugUseOrReferences": "NONE",
"contests": "NONE",
"gambling": false,
"gamblingSimulated": "NONE",
"horrorOrFearThemes": "NONE",
"matureOrSuggestiveThemes": "NONE",
"medicalOrTreatmentInformation": "NONE",
"profanityOrCrudeHumor": "NONE",
"sexualContentGraphicAndNudity": "NONE",
"sexualContentOrNudity": "NONE",
"unrestrictedWebAccess": false,
"violenceCartoonOrFantasy": "NONE",
"violenceRealistic": "NONE",
"violenceRealisticProlongedGraphicOrSadistic": "NONE",
"seventeenPlus": false,
"kidsAgeBand": "NINE_TO_ELEVEN"
}
}Kids Age Bands: FIVE_AND_UNDER, SIX_TO_EIGHT, NINE_TO_ELEVEN
Control how your app rolls out to users.
{
"release": {
"automaticRelease": true,
"phasedRelease": true
}
}Options:
automaticRelease: true - Release immediately upon approvalautomaticRelease: false - Manual release after approvalautomaticRelease: "2025-02-01T10:00:00Z" - Schedule release (RFC 3339)phasedRelease: true - 7-day gradual rollout (1%, 2%, 5%, 10%, 20%, 50%, 100%)Provide contact info and test credentials for the App Review team.
{
"review": {
"firstName": "Jane",
"lastName": "Smith",
"email": "app-review@company.com",
"phone": "+1 (555) 123-4567",
"demoUsername": "demo@example.com",
"demoPassword": "ReviewDemo2025!",
"notes": "To test premium features:\n1. Log in with demo credentials\n2. Navigate to Settings > Subscription\n3. Tap 'Restore Purchase' - sandbox purchase will be restored\n\nFor location features, allow location access when prompted."
}
}Install the Expo Tools extension (opens in a new tab) for:
Push a binary with eas submit before pushing metadata.
Description maximum is 4000 characters.
eas metadata:pull creates a JSON file; import it into your JS config.
Automate metadata updates in your deployment pipeline:
# .eas/workflows/release.yml
jobs:
submit-and-metadata:
steps:
- name: Submit to App Store
run: eas submit -p ios --latest
- name: Push Metadata
run: eas metadata:push