Skip to main content

​
app-tags

Inspect Apple-generated App Store discoverability tags
The app-tags command works with the appTags resources attached to an app in App Store Connect. Apple describes app tags as glanceable terms that help people quickly understand an app or game’s essential qualities. They are generated from your App Store Connect metadata, AI/LLMs, and human curation, and you choose which assigned tags remain visible for your app. Each tag resource currently exposes:
  • name - the label returned by App Store Connect
  • visibleInAppStore - whether that tag is currently visible in the storefront
  • territories - the storefront territories linked to that tag

​
Where They Show Up

Apple says app tags can appear in:
  • App Store search results
  • The search page / search landing experience
  • Your app’s product page
At the time of Apple’s current help text, Apple also says app tags are only displayed to App Store users in the United States. Use this command group when you want to answer:
  • Which tags are attached to an app?
  • Which of those tags are visible in the App Store?
  • Which territories are linked to a specific tag?
  • Do I need full tag resources or just linkage IDs?

​
Usage

​
Quick Start

​
What Each Command Returns

  • list returns full appTags resources for an app.
  • view returns one full appTags resource by tag ID.
  • update mutates the tag’s visibleInAppStore value.
  • territories returns full territory resources linked to a tag.
  • territories-links returns territory relationship IDs only.
  • links returns app-tag relationship IDs only for an app.
If you are starting from scratch, begin with list to discover tag IDs, then use view, territories, or update against one specific tag.

​
Common Flow

​
1. List the tags on an app

​
string
required
App Store Connect app ID (or ASC_APP_ID)
​
string
Filter by visibility with true, false, or a comma-separated combination
​
string
Include related resources. territories is the useful value here.
​
string
Territory fields to include when --include territories is set. Currently: currency
​
integer
Maximum included territories per tag when --include territories is set
​
string
Sort by name or -name

​
2. Inspect one tag in detail

Use view when you already know the tag ID and want the full resource payload.

​
3. Toggle storefront visibility

Only visibleInAppStore is currently mutable through this command surface. Turning visibility off removes that tag from your app’s visible App Store tag set without deleting the underlying tag resource.
​
string
required
App tag ID
​
boolean
required
Set storefront visibility to true or false
​
boolean
default:"false"
required
Required for mutations

​
4. Inspect linked territories

Use territories for full territory resources and territories-links when you only need the relationship IDs.

​
5. Inspect tag linkages for an app

links returns linkage IDs only. It is useful when you want to compare or diff relationships without fetching full tag attributes.

​
Pagination

The collection-style subcommands support standard pagination:

Apps command

Start from the broader app-management surface

Metadata command

Manage other App Store metadata in a file-based workflow