Skip to content

Product Settings

Configure product management, catalog settings, and product display options for your Litekart store.

Product Catalog Configuration

Product Types

Define different types of products in your catalog:

json
{
  "products": {
    "types": {
      "physical": {
        "enabled": true,
        "label": "Physical Product",
        "requires_shipping": true,
        "track_inventory": true
      },
      "digital": {
        "enabled": true,
        "label": "Digital Product",
        "requires_shipping": false,
        "track_inventory": false,
        "auto_fulfill": true
      },
      "service": {
        "enabled": true,
        "label": "Service",
        "requires_shipping": false,
        "track_inventory": false
      }
    }
  }
}

Product Templates

Create product templates for quick product creation:

json
{
  "products": {
    "templates": [
      {
        "name": "T-Shirt",
        "type": "physical",
        "attributes": {
          "size": ["S", "M", "L", "XL"],
          "color": ["Red", "Blue", "Black", "White"]
        },
        "default_settings": {
          "track_inventory": true,
          "allow_backorders": false,
          "weight_unit": "lbs"
        }
      }
    ]
  }
}

Product Attributes & Variants

Attribute Configuration

Configure product attributes and their behavior:

json
{
  "products": {
    "attributes": {
      "max_per_product": 10,
      "types": {
        "text": {
          "validation": {
            "min_length": 1,
            "max_length": 100
          }
        },
        "number": {
          "validation": {
            "min": 0,
            "max": 999999
          }
        },
        "select": {
          "max_options": 20,
          "allow_multiple": false
        }
      }
    }
  }
}

Variant Generation

Configure automatic variant generation:

json
{
  "products": {
    "variants": {
      "auto_generate": true,
      "max_combinations": 100,
      "pricing": {
        "inherit_base_price": true,
        "allow_negative_adjustments": false
      },
      "inventory": {
        "track_per_variant": true,
        "inherit_parent_stock": false
      }
    }
  }
}

Inventory Management

Stock Tracking

Configure inventory tracking settings:

json
{
  "products": {
    "inventory": {
      "track_stock": true,
      "allow_backorders": false,
      "low_stock_threshold": 5,
      "out_of_stock_action": "hide", // "hide" or "show"
      "negative_stock_allowed": false,
      "auto_reorder": {
        "enabled": false,
        "threshold": 10,
        "quantity": 50
      }
    }
  }
}

Stock Updates

Configure automatic stock updates:

json
{
  "products": {
    "stock_updates": {
      "on_order_placed": "reserve", // "reserve" or "deduct"
      "on_order_cancelled": "restore",
      "on_order_refunded": "restore",
      "batch_updates": {
        "enabled": true,
        "max_batch_size": 100
      }
    }
  }
}

Pricing Configuration

Price Display

Configure how prices are displayed:

json
{
  "products": {
    "pricing": {
      "currency": "USD",
      "currency_symbol": "$",
      "currency_position": "before", // "before" or "after"
      "decimal_places": 2,
      "thousand_separator": ",",
      "decimal_separator": ".",
      "show_tax_in_price": false,
      "inclusive_tax_display": true
    }
  }
}

Bulk Pricing

Configure bulk pricing rules:

json
{
  "products": {
    "bulk_pricing": {
      "enabled": true,
      "tiers": [
        {
          "min_quantity": 10,
          "discount_type": "percentage", // "percentage" or "fixed"
          "discount_value": 5
        },
        {
          "min_quantity": 50,
          "discount_type": "percentage",
          "discount_value": 10
        }
      ]
    }
  }
}

Dynamic Pricing

Configure dynamic pricing rules:

json
{
  "products": {
    "dynamic_pricing": {
      "enabled": false,
      "rules": [
        {
          "condition": "customer_group == 'VIP'",
          "action": "discount_percentage",
          "value": 10
        },
        {
          "condition": "cart_total > 100",
          "action": "discount_fixed",
          "value": 15
        }
      ]
    }
  }
}

Product Images & Media

Image Settings

Configure product image requirements and processing:

json
{
  "products": {
    "images": {
      "max_images": 10,
      "max_file_size": "5MB",
      "allowed_formats": ["jpg", "png", "webp"],
      "auto_resize": true,
      "thumbnail_sizes": {
        "small": { "width": 150, "height": 150 },
        "medium": { "width": 400, "height": 400 },
        "large": { "width": 800, "height": 800 }
      },
      "watermark": {
        "enabled": false,
        "image": "path/to/watermark.png",
        "position": "bottom-right",
        "opacity": 0.5
      }
    }
  }
}

Video Support

Configure video support for products:

json
{
  "products": {
    "videos": {
      "enabled": true,
      "max_videos": 3,
      "max_duration": 300, // seconds
      "allowed_formats": ["mp4", "webm", "mov"],
      "auto_compress": true,
      "thumbnail_generation": true
    }
  }
}

Product Categories & Collections

Category Settings

Configure category management:

json
{
  "products": {
    "categories": {
      "max_depth": 3,
      "allow_multiple": true,
      "auto_sort": true,
      "url_structure": "nested", // "nested" or "flat"
      "seo": {
        "auto_generate_meta": true,
        "meta_title_template": "{category_name} - {store_name}",
        "meta_description_template": "Shop {category_name} products at {store_name}"
      }
    }
  }
}

Collections

Configure product collections:

json
{
  "products": {
    "collections": {
      "manual_only": false,
      "auto_update": true,
      "rules": {
        "conditions": [
          {
            "type": "category",
            "operator": "in",
            "value": ["electronics", "gadgets"]
          },
          {
            "type": "price",
            "operator": "between",
            "value": [10, 100]
          }
        ]
      }
    }
  }
}

Product Reviews & Ratings

Review Settings

Configure product review system:

json
{
  "products": {
    "reviews": {
      "enabled": true,
      "require_purchase": true,
      "moderation": {
        "auto_approve": false,
        "keywords_filter": ["spam", "inappropriate"],
        "max_reviews_per_day": 5
      },
      "rating_scale": 5,
      "allow_images": true,
      "max_images_per_review": 3
    }
  }
}

Review Analytics

Configure review analytics:

json
{
  "products": {
    "review_analytics": {
      "enabled": true,
      "aggregate_ratings": true,
      "featured_reviews": {
        "enabled": true,
        "criteria": "highest_rated",
        "count": 3
      }
    }
  }
}

Product Import/Export

Import Configuration

Configure product import settings:

json
{
  "products": {
    "import": {
      "formats": ["csv", "xlsx", "json"],
      "batch_size": 100,
      "validate_before_import": true,
      "update_existing": true,
      "skip_errors": false,
      "field_mapping": {
        "name": "Product Name",
        "price": "Price",
        "sku": "SKU"
      }
    }
  }
}

Export Configuration

Configure product export settings:

json
{
  "products": {
    "export": {
      "formats": ["csv", "xlsx", "xml"],
      "include_images": true,
      "include_variants": true,
      "include_inventory": true,
      "date_range_filter": true,
      "compression": "gzip"
    }
  }
}

SEO & Meta Configuration

Product SEO

Configure SEO settings for products:

json
{
  "products": {
    "seo": {
      "auto_generate": {
        "meta_title": true,
        "meta_description": true,
        "url_slug": true
      },
      "templates": {
        "meta_title": "{product_name} - {brand} | {store_name}",
        "meta_description": "Buy {product_name} online. {short_description} Shop now at {store_name}",
        "url_slug": "{product_name}-{sku}"
      },
      "open_graph": {
        "enabled": true,
        "image_fallback": "default-product-image.jpg"
      }
    }
  }
}

Product Search & Filtering

Search Configuration

Configure product search settings:

json
{
  "products": {
    "search": {
      "engine": "elasticsearch", // "database" or "elasticsearch"
      "fuzzy_search": true,
      "partial_matches": true,
      "boost_exact_matches": true,
      "searchable_fields": ["name", "description", "sku", "tags"],
      "excluded_words": ["a", "an", "the", "and", "or"]
    }
  }
}

Filter Configuration

Configure product filtering options:

json
{
  "products": {
    "filters": {
      "price_ranges": [
        { "min": 0, "max": 25, "label": "Under $25" },
        { "min": 25, "max": 50, "label": "$25 - $50" },
        { "min": 50, "max": 100, "label": "$50 - $100" }
      ],
      "attributes": {
        "color": { "display_type": "color_swatch" },
        "size": { "display_type": "buttons" },
        "brand": { "display_type": "checkbox" }
      },
      "sort_options": [
        { "value": "name", "label": "Name A-Z" },
        { "value": "-name", "label": "Name Z-A" },
        { "value": "price", "label": "Price Low to High" },
        { "value": "-price", "label": "Price High to Low" }
      ]
    }
  }
}

Performance Optimization

Caching

Configure product caching:

json
{
  "products": {
    "caching": {
      "enabled": true,
      "ttl": 3600, // seconds
      "invalidate_on_update": true,
      "cache_variants": true,
      "cache_search_results": true
    }
  }
}

Database Optimization

Optimize database queries for products:

json
{
  "products": {
    "database": {
      "index_fields": ["sku", "name", "category_id", "price"],
      "partition_large_tables": false,
      "query_cache": true,
      "connection_pool": {
        "min": 2,
        "max": 10,
        "idle_timeout": 30000
      }
    }
  }
}

Product Lifecycle

Product Status

Configure product status workflow:

json
{
  "products": {
    "lifecycle": {
      "statuses": {
        "draft": { "label": "Draft", "visible": false },
        "active": { "label": "Active", "visible": true },
        "inactive": { "label": "Inactive", "visible": false },
        "discontinued": { "label": "Discontinued", "visible": true }
      },
      "auto_archive": {
        "enabled": false,
        "inactive_days": 365
      }
    }
  }
}

Troubleshooting

Common Product Issues

Images Not Uploading

  • Check file size limits
  • Verify allowed formats
  • Check storage permissions

Variants Not Generating

  • Verify attribute configuration
  • Check combination limits
  • Review variant rules

Search Not Working

  • Check search engine configuration
  • Verify index status
  • Review searchable fields

Debug Mode

Enable product debugging:

bash
# Environment variable
DEBUG_PRODUCTS=true

# Check product logs
tail -f logs/products.log

Performance Monitoring

Monitor product performance:

sql
-- Check slow product queries
SELECT query, total_time, calls
FROM pg_stat_statements
WHERE query LIKE '%products%'
ORDER BY total_time DESC
LIMIT 10;

-- Monitor product cache hit rate
SELECT * FROM product_cache_stats;