Skip to content

Store Metadata

Besides images, a store listing has text: title, descriptions, keywords, release notes. Chameleon Store Studio reads it from plain text files in your repository, validates it with the listing text rules, shows it in the listing preview, and uploads it when you publish.

Metadata is optional. Without it, image validation and publishing of images still work.

Folder structure

By default files live in store/metadata/ inside the module (metadata.directory), one folder per locale:

app/store/metadata/
├── en-US/
│   ├── play/
│   │   ├── title.txt
│   │   ├── short_description.txt
│   │   ├── full_description.txt
│   │   └── release_notes.txt
│   └── appstore/
│       ├── name.txt
│       ├── subtitle.txt
│       ├── keywords.txt
│       ├── promotional_text.txt
│       ├── description.txt
│       ├── release_notes.txt
│       ├── support_url.txt
│       └── marketing_url.txt
└── es-MX/
    ├── play/title.txt
    └── appstore/subtitle.txt

Every file is optional. Leading and trailing whitespace is trimmed.

Google Play files

File Limit
title.txt 30 characters
short_description.txt 80 characters
full_description.txt 4000 characters
release_notes.txt 500 characters

App Store files

File Limit
name.txt 30 characters
subtitle.txt 30 characters
keywords.txt 100 bytes, comma-separated
promotional_text.txt 170 characters
description.txt 4000 characters
release_notes.txt 4000 characters
support_url.txt valid URL
marketing_url.txt valid URL

One layout only

Only the <locale>/play/ and <locale>/appstore/ folders and the file names above are read. storeParseMetadata warns when it finds files from other layouts (android/, ios/ or appstore/ folders at the top level, or .txt files placed directly in a locale folder) and ignores them. Rename or move them.

Fallback to the default locale

Fields missing in a locale are taken from metadata.defaultLocale (default en-US). Translate only what differs; for example es-MX can provide just a title and short description.

storeStudio {
    metadata {
        directory.set(layout.projectDirectory.dir("store/metadata"))
        defaultLocale.set("en-US")
    }
}

Parsed output

./gradlew storeParseMetadata writes the resolved text, after fallback, to build/store/metadata/metadata.json. Validation, the listing preview and publishing read this file. It runs automatically when needed.