Skip to content

gplay listings

Manage store listings in an edit.

gplay listings <subcommand> [flags]

Manage store listings within an edit.

Store listing fields:

  • title: App name (max 30 characters for most locales)
  • shortDescription: Promotional text (max 80 characters)
  • fullDescription: Full app description (max 4000 characters)
  • video: YouTube video URL (optional)

Listings are scoped to an edit. Create an edit first with gplay edits create.

List listings in an edit.

gplay listings list --package <name> --edit <id>
Flag Description Default
--edit Edit ID ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false

Get a listing.

gplay listings get --package <name> --edit <id> --locale <lang>
Flag Description Default
--edit Edit ID ``
--locale Locale (e.g. en-US) ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false

Update or create a listing.

gplay listings update --package <name> --edit <id> --locale <lang> [flags]

Update a store listing for a specific locale.

Sets all fields for the given locale. Fields not provided will be cleared. Use gplay listings patch for partial updates.

Examples: gplay listings update –package com.example –edit EDIT_ID –locale en-US –title “My App” –short-description “A great app” gplay listings update –package com.example –edit EDIT_ID –locale en-US –title “My App” –video “https://youtube.com/watch?v=…”

Flag Description Default
--edit Edit ID ``
--full-description Full description ``
--locale Locale (e.g. en-US) ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false
--short-description Short description ``
--title Listing title ``
--video YouTube promotional video URL (empty to clear) ``

Patch a listing.

gplay listings patch --package <name> --edit <id> --locale <lang> [flags]
Flag Description Default
--edit Edit ID ``
--full-description Full description ``
--locale Locale (e.g. en-US) ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false
--short-description Short description ``
--title Listing title ``
--video YouTube promotional video URL (empty to clear) ``

Delete a listing.

gplay listings delete --package <name> --edit <id> --locale <lang> --confirm
Flag Description Default
--confirm Confirm delete false
--edit Edit ID ``
--locale Locale (e.g. en-US) ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false

Delete all listings in an edit.

gplay listings delete-all --package <name> --edit <id> --confirm
Flag Description Default
--confirm Confirm delete false
--edit Edit ID ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false

List supported locales for an app’s store listings.

gplay listings locales --package <name> [flags]
Flag Description Default
--edit Edit ID (if omitted, creates a temporary edit) ``
--output Output format: json (default), table, markdown json
--package Package name (applicationId) ``
--pretty Pretty-print JSON output false