Category Commands

Manage App Store categories

Overview

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

Commands

List available App Store categories.

integer

default:"200"

Maximum results to fetch (1-200)

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 view`

View a specific category.

string

required

Category ID (e.g., GAMES)

Examples:

asc categories view --category-id "GAMES"

`asc categories parent`

Get the parent category.

string

required

Category ID

Examples:

asc categories parent --category-id "GAMES_ACTION"

`asc categories subcategories`

List subcategories for a category.

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.

string

required

App Store Connect app ID

string

required

Primary category ID

string

Secondary category ID

string

Primary category first subcategory ID

string

Primary category second subcategory ID

string

Secondary category first subcategory ID

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

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.

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

Categories

Category Commands

Overview

Commands

`asc categories view`

`asc categories parent`

`asc categories subcategories`

`asc categories set`

Common Usage Patterns

List all categories

Find subcategories for Games

Set app categories

Update categories for an existing app

Common Categories

iOS Categories

Games Subcategories

Category Requirements

​Category Commands

​Overview

​Commands

​asc categories list

​asc categories view

​asc categories parent

​asc categories subcategories

​asc categories set

​Common Usage Patterns

​List all categories

​Find subcategories for Games

​Set app categories

​Update categories for an existing app

​Common Categories

​iOS Categories

​Games Subcategories

​Category Requirements

Category Commands

Overview

Commands

`asc categories list`

`asc categories view`

`asc categories parent`

`asc categories subcategories`

`asc categories set`

Common Usage Patterns

List all categories

Find subcategories for Games

Set app categories

Update categories for an existing app

Common Categories

iOS Categories

Games Subcategories

Category Requirements