DocumentationGetting StartedCreating Your First Classification

Creating Your First Classification

The fastest way to see Product Classifier in action is through the Playground—a web interface where you can test classifications instantly without writing any code. This guide walks you through your first classification.

Open the Playground

Navigate to the Playground in your Product Classifier dashboard. The Playground is available immediately after creating your account—no API keys or setup required.

Enter a Product Description

In the description field, enter details about the product you want to classify. The AI works best with clear, relevant information about the product.

What to Include

  • Product name and brand : “Apple iPhone 16 Pro” or “Nike Air Max 270”
  • Key features : Screen size, materials, specifications
  • Use cases : What the product does or who it’s for
  • Category hints : Any details that clarify the product type

Description Length

Aim for 10-200 words. Brief descriptions work if the product is straightforward (“Leather wallet with RFID blocking”), but more complex products benefit from additional detail.

Example Descriptions

Good:

Dyson V15 Detect cordless vacuum cleaner with laser dust detection. Features a 60-minute runtime, HEPA filtration, and LCD screen showing real-time particle count. Includes multiple attachments for floors, upholstery, and hard-to-reach areas.

Too vague:

Vacuum cleaner

Adjust Settings (Optional)

The default settings work fine for your first classification, but you can customize the behavior by clicking the Settings button in the top-right corner. Available settings include:

  • Taxonomy : Choose between Shopify or Google Product Taxonomy
  • Custom instructions for AI : Guide the AI’s decision-making with natural language prompts
  • Leaf only : Require classifications at the leaf level only
  • Use top-ranked category if AI cannot decide : Return the highest-ranked option when multiple categories are equally likely

For detailed explanations of each setting, see Using the Playground.

Categorize

Click the Categorize button. The AI analyzes your product description and returns results within a few seconds.

Understanding Your Results

After classification, you’ll see a colored indicator and category information.

Status Indicators

  • 🟢 : AI-selected category (successful classification)
  • 🟡 : Top-ranked category was used, AI couldn’t decide
  • ⚫ : No category was found
  • 🔴 : Error occurred

A green indicator means the AI confidently matched your product to a specific category—this is what you want to see.

For a more detailed description of classification statuses, see Using the Playground.

Category Information

The results show:

  • Category ID : The unique identifier (e.g., el-17-2-1)
  • Full path : The hierarchy from root to leaf (e.g., Electronics > Video > Projectors > Multimedia Projectors)

This is the same category information returned by the API, formatted for easy reading.

Next Steps

Once you’ve tested a few classifications in the Playground:

Understanding TaxonomiesPricing and Plans Explained