Skip to main content
The Product Management interface provides comprehensive tools for building and maintaining your product catalog. Manage products, variants, inventory, pricing, images, categories, and collections all in one place.

​
Product List Overview

The product list provides a comprehensive view of your entire catalog:
  • Product Images: Thumbnail previews for quick identification
  • Product Details: Title, subtitle, handle, and creation date
  • Inventory Status: Real-time stock levels across all variants
  • Variant Count: Number of product variations available
  • Status Indicators: Draft, proposed, published, or rejected status
  • Quick Actions: Edit, view details, manage variants

​
Status Filtering

Filter products by status using the tab navigation:
  • All: View all products regardless of status
  • Draft: Products not yet ready for publication
  • Proposed: Products awaiting approval
  • Published: Live products visible to customers
  • Rejected: Products that didn’t meet approval criteria

​
Creating a Product

1

Open Product Creation

Click the “Create Product” button in the top right of the product list.
2

Enter Basic Information

Fill in the product title, subtitle, and description. The handle (URL slug) is automatically generated but can be customized.
3

Set Product Type & Categories

Assign product types and categories to help organize your catalog.
4

Configure Product Options

Add options like Size, Color, or Material that will define your variants.
5

Create Variants

Generate variants based on your options. Each variant can have unique SKU, pricing, and inventory.
6

Upload Media

Add product images and set their display order.
7

Set Status

Choose whether to save as draft or publish immediately.

​
Product Details

​
Basic Information

Title: The main product name displayed to customers Subtitle: Optional secondary description for additional context Description: Rich text editor supporting formatted content, lists, and links Handle: URL-friendly slug used in product URLs (e.g., /products/blue-cotton-shirt) Product Type: Categorization for filtering and organization Gift Card: Toggle to mark product as a gift card Discountable: Control whether discount codes can be applied

​
Product Options

Options define the characteristics that create variants: 
// Size Option
{
  title: "Size",
  values: ["Small", "Medium", "Large", "X-Large"]
}

// Color Option
{
  title: "Color",
  values: ["Black", "White", "Navy", "Gray"]
}

// Material Option
{
  title: "Material",
  values: ["Cotton", "Polyester", "Blend"]
}
Variants are automatically generated from combinations of option values:
  • 4 sizes × 4 colors = 16 variants
  • 4 sizes × 4 colors × 3 materials = 48 variants
Be cautious when adding options - the number of variants grows multiplicatively. Consider carefully whether you need all combinations.

​
Managing Variants

​
Variant Details

Each variant includes: Title: Combination of option values (e.g., “Small / Black”) SKU: Stock keeping unit for inventory management Barcode/EAN/UPC: Product identification codes Inventory:
  • Current quantity in stock
  • Manage inventory toggle
  • Allow backorder option
Dimensions:
  • Weight, length, height, width
  • Origin country
Pricing:
  • Base price per region
  • Multi-currency support
  • Customer group pricing

​
Variant Operations

Edit Variant

Click on any variant to edit its details, pricing, or inventory.

Bulk Update

Update multiple variants at once for pricing or inventory changes.

Duplicate Variant

Create a copy of an existing variant as a starting point.

Delete Variant

Remove variants that are no longer needed (cannot be undone).

​
Product Media

​
Image Management

The Media tab provides tools for managing product images:
1

Upload Images

Drag and drop images or click to browse. Supports JPG, PNG, WebP formats.
2

Set Display Order

Drag images to reorder. The first image becomes the product thumbnail.
3

Add Alt Text

Provide descriptive text for accessibility and SEO.
4

Assign to Variants

Associate specific images with individual variants.
Image Best Practices:
  • Use high-resolution images (at least 1200×1200 pixels)
  • Maintain consistent aspect ratios across products
  • Include multiple angles and detail shots
  • Optimize file sizes for web performance
  • Add descriptive alt text for all images

​
Inventory Management

​
Stock Tracking

Manage inventory for each variant: Inventory Quantity: Current stock level Manage Inventory: Enable/disable stock tracking Allow Backorder: Permit orders when out of stock

​
Stock Movements

Track inventory changes over time:
  • Initial stock additions
  • Order fulfillment deductions
  • Return additions
  • Manual adjustments
  • Stock transfers between locations

​
Low Stock Alerts

Set up notifications for low inventory: 
// Configure per variant
{
  lowStockThreshold: 10,
  notifyOnLowStock: true,
  autoReorderEnabled: false
}

​
Pricing & Money Amounts

​
Regional Pricing

Set different prices per region and currency: 
{
  region: "United States",
  currency: "USD",
  amount: 2999, // $29.99
  compareAtAmount: 3999 // $39.99 (sale price)
}
Prices are stored in the smallest currency unit (cents, pence, etc.) to avoid floating-point errors.

​
Customer Group Pricing

Offer special pricing to specific customer segments:
  • Wholesale customers
  • VIP members
  • Corporate accounts
  • Subscription tiers

​
Categories & Collections

​
Product Categories

Organize products in hierarchical categories:
  • Electronics > Computers > Laptops
  • Clothing > Men’s > Shirts
  • Home > Kitchen > Appliances
Categories support:
  • Nested hierarchies
  • Custom descriptions
  • SEO metadata
  • Featured products

​
Product Collections

Group products for merchandising:
  • Seasonal: Summer Collection, Holiday Gifts
  • Promotional: Best Sellers, New Arrivals
  • Thematic: Eco-Friendly, Made in USA
  • Event-based: Back to School, Black Friday
Collections can be:
  • Manually curated
  • Automatically generated based on rules
  • Time-limited for promotions

​
Search & Filtering

Search across multiple fields:
  • Product title
  • Product subtitle
  • Product handle
  • SKU codes
  • Barcodes

​
Advanced Filters

Combine filters for precise results:
  • Status: Draft, published, etc.
  • Type: Product type classification
  • Categories: One or more categories
  • Collections: Product collections
  • Inventory: In stock, low stock, out of stock
  • Price Range: Min and max price

​
Product Attributes

​
Metadata

Store custom product information: 
{
  "care_instructions": "Machine wash cold, tumble dry low",
  "made_in": "Portugal",
  "materials": ["Cotton", "Elastane"],
  "certifications": ["GOTS", "Fair Trade"],
  "model_height": "6'1\"",
  "model_size": "M"
}

​
Tags

Add searchable tags for organization:
  • Season: summer, winter, fall, spring
  • Features: organic, vegan, handmade
  • Promotions: sale, clearance, new
  • Attributes: breathable, waterproof, stretch

​
Best Practices

  • Write clear, descriptive titles
  • Use meaningful product handles
  • Provide detailed descriptions
  • Include size guides and measurements
  • Specify materials and care instructions
  • Keep option names consistent (“Size” not “Sizes”)
  • Order option values logically (XS, S, M, L, XL)
  • Use standard industry terminology
  • Don’t create unnecessary variants
  • Consider demand when generating all combinations
  • Enable inventory tracking for physical products
  • Set realistic low stock thresholds
  • Update inventory promptly after receiving stock
  • Use stock movements to track history
  • Consider safety stock levels
  • Set competitive prices based on market research
  • Use compare-at prices for sale items
  • Configure regional pricing appropriately
  • Account for shipping costs in pricing
  • Review pricing regularly

​
Troubleshooting

​
Common Issues

Products not appearing on storefront
  • Verify status is set to “Published”
  • Check that inventory is available
  • Ensure product is assigned to appropriate collections
  • Confirm visibility settings are correct
Variants not generating correctly
  • Review option configuration
  • Ensure option values are properly saved
  • Check for duplicate option combinations
  • Try regenerating variants after fixing options
Inventory discrepancies
  • Review stock movement history
  • Check for unfulfilled orders
  • Verify manual adjustments
  • Reconcile with physical inventory counts
Image upload failures
  • Check file size (max 10MB recommended)
  • Verify file format (JPG, PNG, WebP)
  • Ensure stable internet connection
  • Try different browser if issues persist

Build docs developers (and LLMs) love

Get started for freeTalk to us