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

asc app-tags <subcommand> [flags]

​
Quick Start

asc app-tags list --app "APP_ID"
asc app-tags view --app "APP_ID" --id "TAG_ID"
asc app-tags update --id "TAG_ID" --visible-in-app-store=false --confirm
asc app-tags territories --id "TAG_ID"
asc app-tags links --app "APP_ID"

​
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

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

​
2. Inspect one tag in detail

asc app-tags view --app "APP_ID" --id "TAG_ID"
asc app-tags view --app "APP_ID" --id "TAG_ID" --include territories --territory-fields currency
Use view when you already know the tag ID and want the full resource payload.

​
3. Toggle storefront visibility

asc app-tags update --id "TAG_ID" --visible-in-app-store --confirm
asc app-tags update --id "TAG_ID" --visible-in-app-store=false --confirm
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.
​
--id
string
required
App tag ID
​
--visible-in-app-store
boolean
required
Set storefront visibility to true or false
​
--confirm
boolean
default:"false"
required
Required for mutations

​
4. Inspect linked territories

asc app-tags territories --id "TAG_ID"
asc app-tags territories --id "TAG_ID" --fields currency
asc app-tags territories-links --id "TAG_ID"
Use territories for full territory resources and territories-links when you only need the relationship IDs.

​
5. Inspect tag linkages for an app

asc app-tags links --app "APP_ID"
asc app-tags links --app "APP_ID" --paginate
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: 
asc app-tags list --app "APP_ID" --paginate
asc app-tags list --next "<links.next>"
asc app-tags territories --id "TAG_ID" --paginate
asc app-tags links --app "APP_ID" --paginate

Apps command

Start from the broader app-management surface

Metadata command

Manage other App Store metadata in a file-based workflow