Validation
./gradlew storeValidate checks the exported images and listing text against Google Play and App
Store rules, before you upload anything. The report is written to
build/store/validation/report.json, printed in the console, and shown in the IDE's
Validation tab .
Severities
Severity
Meaning
ERROR
The store would reject it. Fails the task.
WARNING
Allowed, but probably a mistake. Fails only with failOnWarning.
INFO
For your information.
Some rules are hard requirements (marked hard below): their severity can't be lowered below
ERROR.
storeStudio {
validation {
failOnWarning . set ( true )
featureGraphicMissing . set ( Severity . WARNING ) // e.g. while the banner is in progress
severityOverrides . put ( "PLAY_PROMO_ELIGIBILITY" , Severity . WARNING )
attachToCheck . set ( true ) // run with ./gradlew check
}
}
Application and library modules
Rules about the listing as a whole (how many screenshots, required sets, feature graphic,
locale coverage, listing text) only apply to the module that produces the listing: the
application module. Library modules (:feature:*, a KMP :shared module) only contribute some
screenshots, so they run the per-image rules (format, size, transparency, text overflow). This
lets ./gradlew storeValidate pass in multi-module projects.
Rules
Every image
Rule
Severity
Description
ASSET_RENDER_FAILED
ERROR, hard
The screenshot failed in every rendering engine.
ASSET_RENDER_FALLBACK_USED
INFO
Rendered by Robolectric instead of Layoutlib.
ASSET_DIMENSIONS_MISMATCH
ERROR, hard
Size differs from the slot's exact dimensions.
ASSET_ALPHA_CHANNEL
ERROR, hard
The exported file still has transparency.
ASSET_INDEX_STALE
ERROR, hard
The export index points to a file that no longer exists.
SEMANTICS_TEXT_OVERFLOW
WARNING
Text is cut off or overflowing (often a long translation).
ORDER_DUPLICATE
WARNING
Two screenshots share the same order in a set.
Google Play
Rule
Severity
Description
PLAY_SCREENSHOT_FORMAT
ERROR, hard
Must be PNG or JPEG.
PLAY_SCREENSHOT_ALPHA
ERROR, hard
No transparency.
PLAY_SCREENSHOT_FILE_SIZE
ERROR, hard
At most 8 MB (8,000,000 bytes).
PLAY_SCREENSHOT_MIN_SIDE
ERROR, hard
Short side at least 320 px.
PLAY_SCREENSHOT_MAX_SIDE
ERROR, hard
Long side at most 3840 px.
PLAY_SCREENSHOT_ASPECT_RATIO
ERROR, hard
Long side at most twice the short side.
PLAY_WEAR_SQUARE
ERROR, hard
Wear OS screenshots are square, at least 384 px.
PLAY_SCREENSHOT_COUNT_MIN
ERROR, hard
At least 2 phone screenshots per locale. Flags a locale with exactly one.
PLAY_SCREENSHOT_COUNT_MAX
ERROR, hard
At most 8 screenshots per device type and locale.
PLAY_PROMO_ELIGIBILITY
INFO
Promotion requires at least 4 phone screenshots with a short side of 1080 px or more.
PLAY_FEATURE_GRAPHIC_REQUIRED
ERROR (configurable)
A 1024 × 500 feature graphic per locale. Set the severity with featureGraphicMissing.
PLAY_FEATURE_GRAPHIC_DIMENSIONS
ERROR, hard
Exactly 1024 × 500 px.
PLAY_FEATURE_GRAPHIC_FORMAT
ERROR, hard
Opaque PNG or JPEG, without transparency.
PLAY_FEATURE_GRAPHIC_FILE_SIZE
ERROR, hard
At most 15 MB (15,000,000 bytes).
PLAY_FEATURE_GRAPHIC_DUPLICATE
ERROR, hard
One feature graphic per locale.
PLAY_TABLET_PARTIAL
WARNING
Some locales have tablet screenshots and others don't.
App Store
Apple publishes no hard file-size limit, so the App Store size check is a recommendation only.
Rule
Severity
Description
ASC_SCREENSHOT_FORMAT
ERROR, hard
PNG or JPEG.
ASC_SCREENSHOT_ALPHA
ERROR, hard
No transparency.
ASC_SCREENSHOT_COLOR_SPACE
ERROR, hard
sRGB color profile.
ASC_SCREENSHOT_DIMENSIONS
ERROR, hard
An accepted size for the display type.
ASC_SCREENSHOT_FILE_SIZE
WARNING
Above 10 MiB, the recommended App Store limit.
ASC_SCREENSHOT_COUNT_MIN
ERROR, hard
At least 1 screenshot per display set.
ASC_SCREENSHOT_COUNT_MAX
ERROR, hard
At most 10 screenshots per display set.
ASC_ORIENTATION_CONSISTENCY
ERROR, hard
One orientation per display set.
ASC_IPHONE_69_REQUIRED
ERROR, hard
The iPhone 6.9" set is required.
ASC_IPAD_13_REQUIRED
ERROR, hard
The iPad 13" set is required when the app supports iPad.
ASC_IPAD_UNEXPECTED
WARNING
iPad images exist but appStore.supportsIpad is false.
Locales
Rule
Severity
Description
LOCALE_COVERAGE
ERROR, hard
A configured store has no images for a locale.
LOCALE_COVERAGE_INCONSISTENT
WARNING
Locales have different numbers of images in the same set.
Listing text
These run when store metadata is present.
Rule
Severity
Description
PLAY_TEXT_TITLE_LENGTH
ERROR, hard
Title up to 30 characters.
PLAY_TEXT_SHORT_DESC_LENGTH
ERROR, hard
Short description up to 80 characters.
PLAY_TEXT_FULL_DESC_LENGTH
ERROR, hard
Full description up to 4000 characters.
PLAY_TEXT_RELEASE_NOTES_LENGTH
ERROR, hard
Release notes up to 500 characters.
METADATA_POLICY_CLAIMS
WARNING
Ranking or price claims ("best", "#1", "free") that Google Play policy discourages.
METADATA_POLICY_PUNCTUATION
WARNING
Excessive punctuation such as !!!.
APPSTORE_TEXT_NAME_LENGTH
ERROR, hard
Name up to 30 characters.
APPSTORE_TEXT_SUBTITLE_LENGTH
ERROR, hard
Subtitle up to 30 characters.
APPSTORE_TEXT_KEYWORDS_LENGTH
ERROR, hard
Keywords up to 100 bytes.
APPSTORE_TEXT_PROMO_LENGTH
ERROR, hard
Promotional text up to 170 characters.
APPSTORE_TEXT_DESC_LENGTH
ERROR, hard
Description up to 4000 characters.
APPSTORE_TEXT_WHATS_NEW_LENGTH
ERROR, hard
What's New up to 4000 characters.
APPSTORE_TEXT_SUPPORT_URL
ERROR, hard
A valid http:// or https:// URL, when set.
APPSTORE_TEXT_MARKETING_URL
ERROR, hard
A valid http:// or https:// URL, when set.
APPSTORE_TEXT_EMOJI_FORBIDDEN
WARNING
Emoji in name, subtitle or keywords.