Categories

Category Commands

Manage App Store categories

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 view

View a specific category.

--category-id · string · required

Category ID (e.g., GAMES)

Examples:

asc categories view --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.