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;