gplay-metadata-sync

Sync and localize Google Play Store listing metadata using Fastlane directory format.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/lettucebo/Skills --skill gplay-metadata-sync-lettucebo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gplay-metadata-sync
Source: https://github.com/lettucebo/Skills/tree/main/skills/google-play-console-cli/gplay-metadata-sync
Command: npx skills add https://github.com/lettucebo/Skills --skill gplay-metadata-sync-lettucebo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Play Store listings across multiple locales is tedious and error-prone when done manually through the Play Console, especially when keeping titles, descriptions, and screenshots consistent and within character limits. ## Core Features & Use Cases - Fastlane-Format Sync: Export and import store listings and images between the Play Store and a local Fastlane metadata directory structure. - Multi-Locale Management: Create, update, and validate localized listings (title, short description, full description, video) across locales like en-US, es-ES, and ja-JP. - Image and Screenshot Management: Upload, list, and delete phone, tablet, TV, and Wear OS screenshots, plus icons and feature graphics. - Use Case: Export your app's current listings, edit the full description locally, validate it against the 4000-character limit, preview the diff, and import the changes back to the Play Store in one workflow. ## Quick Start Ask the agent to export the Play Store listings for your app package into a Fastlane metadata directory, then validate and re-import the updated descriptions.

Frequently Asked Questions about gplay-metadata-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Google Play Store metadata with Fastlane format?▼

Use gplay sync export-listings to download listings into a fastlane/metadata/android directory, edit the text files locally, then run gplay sync import-listings to push changes back. Use diff-listings to preview changes before importing.

How to update Google Play listing descriptions for multiple locales?▼

Copy an existing locale directory (e.g., en-US) to a new locale folder like es-ES, translate the text files, then run gplay sync import-listings with your package name and metadata directory to publish all locales at once.

What are the Google Play character limits for titles and descriptions?▼

Google Play limits titles to 30 characters, short descriptions to 80 characters, and full descriptions to 4000 characters. Run gplay validate listing against your metadata directory to catch violations before importing.

Can I upload screenshots to Google Play from the command line?▼

Yes, use gplay images upload with the package name, edit ID, locale, image type (phoneScreenshots, icon, featureGraphic, etc.), and file path. You can also list and delete existing images with the images list and images delete commands.

What is the difference between listings update and listings patch?▼

listings update sets all fields for a locale and clears any fields not provided as flags, while listings patch performs partial updates only on the specified fields. Use patch when you want to change one field without affecting others.