Skip to main content

​
Overview

Category commands manage App Store categories for your app, including primary and secondary categories.

​
Commands

​
asc categories list

List available App Store categories.
​
--limit
integer
default:"200"
Maximum results to fetch (1-200)
​
--output
string
default:"json"
Output format: json, table
Examples: 
asc categories list
asc categories list --output table
Response: 
{
  "data": [
    {
      "id": "GAMES",
      "type": "appCategories",
      "attributes": {
        "platforms": ["IOS", "MAC_OS"]
      }
    },
    {
      "id": "PRODUCTIVITY",
      "type": "appCategories",
      "attributes": {
        "platforms": ["IOS", "MAC_OS", "TV_OS"]
      }
    },
    {
      "id": "PHOTO_AND_VIDEO",
      "type": "appCategories",
      "attributes": {
        "platforms": ["IOS", "MAC_OS"]
      }
    }
  ]
}

​
asc categories get

Get a specific category.
​
--category-id
string
required
Category ID (e.g., GAMES)
Examples: 
asc categories get --category-id "GAMES"

​
asc categories parent

Get the parent category.
​
--category-id
string
required
Category ID
Examples: 
asc categories parent --category-id "GAMES_ACTION"

​
asc categories subcategories

List subcategories for a category.
​
--category-id
string
required
Category ID
Examples: 
asc categories subcategories --category-id "GAMES"
Response: 
{
  "data": [
    {
      "id": "GAMES_ACTION",
      "type": "appCategories"
    },
    {
      "id": "GAMES_ADVENTURE",
      "type": "appCategories"
    },
    {
      "id": "GAMES_SIMULATION",
      "type": "appCategories"
    }
  ]
}

​
asc categories set

Set primary and secondary categories for an app.
The app must have an editable version in PREPARE_FOR_SUBMISSION state.
​
--app
string
required
App Store Connect app ID
​
--primary
string
required
Primary category ID
​
--secondary
string
Secondary category ID
​
--primary-subcategory-one
string
Primary category first subcategory ID
​
--primary-subcategory-two
string
Primary category second subcategory ID
​
--secondary-subcategory-one
string
Secondary category first subcategory ID
​
--secondary-subcategory-two
string
Secondary category second subcategory ID
Examples: 
asc categories set --app 123456789 --primary GAMES
asc categories set --app 123456789 --primary GAMES --secondary ENTERTAINMENT
asc categories set --app 123456789 --primary GAMES --primary-subcategory-one GAMES_ACTION --primary-subcategory-two GAMES_SIMULATION
asc categories set --app 123456789 --primary GAMES --primary-subcategory-one GAMES_ACTION --secondary ENTERTAINMENT
asc categories set --app 123456789 --primary PHOTO_AND_VIDEO
Response: 
{
  "success": true,
  "app": "123456789",
  "primaryCategory": "GAMES",
  "secondaryCategory": "ENTERTAINMENT",
  "primarySubcategoryOne": "GAMES_ACTION"
}

​
Common Usage Patterns

​
List all categories

asc categories list --output table

​
Find subcategories for Games

asc categories subcategories --category-id "GAMES" --output json

​
Set app categories

asc categories set --app "123456789" --primary GAMES --primary-subcategory-one GAMES_ACTION

​
Update categories for an existing app

asc categories set --app "123456789" --primary PRODUCTIVITY --secondary BUSINESS

​
Common Categories

​
iOS Categories

  • BOOKS
  • BUSINESS
  • DEVELOPER_TOOLS
  • EDUCATION
  • ENTERTAINMENT
  • FINANCE
  • FOOD_AND_DRINK
  • GAMES
  • GRAPHICS_AND_DESIGN
  • HEALTH_AND_FITNESS
  • LIFESTYLE
  • MAGAZINES_AND_NEWSPAPERS
  • MEDICAL
  • MUSIC
  • NAVIGATION
  • NEWS
  • PHOTO_AND_VIDEO
  • PRODUCTIVITY
  • REFERENCE
  • SHOPPING
  • SOCIAL_NETWORKING
  • SPORTS
  • STICKERS
  • TRAVEL
  • UTILITIES
  • WEATHER

​
Games Subcategories

  • GAMES_ACTION
  • GAMES_ADVENTURE
  • GAMES_ARCADE
  • GAMES_BOARD
  • GAMES_CARD
  • GAMES_CASINO
  • GAMES_FAMILY
  • GAMES_MUSIC
  • GAMES_PUZZLE
  • GAMES_RACING
  • GAMES_ROLE_PLAYING
  • GAMES_SIMULATION
  • GAMES_SPORTS
  • GAMES_STRATEGY
  • GAMES_TRIVIA
  • GAMES_WORD

​
Category Requirements

  • Every app must have a primary category
  • Apps can optionally have a secondary category
  • Some categories (like GAMES) support up to two subcategories
  • Categories must be appropriate for the app’s platform (iOS, macOS, tvOS, visionOS)
  • The app must have an editable version to change categories
Choosing the right category is important for App Store discoverability. Select the category that best describes your app’s primary functionality.