Skip to main content

Products

The Products module acts as the central command center for your store's inventory. It allows you to define exactly what you sell, how it looks to customers, and how pricing works across different markets. Whether you are selling a single digital file or managing a complex catalog with thousands of variants, this system gives you precision control over your business.

This guide will show you how to create, configure, and organize products in Soppiya.

Location: Products

What Is the Products Module?​

The Products module is the database of every item available in your store. It handles the "Three P's" of commerce: Presentation (images/descriptions), Pricing (costs/discounts), and Provisioning (inventory/shipping).

Product structures in Soppiya:

  • Simple Product - An item with no variations (e.g., "Standard Water Bottle").
  • Variable Product - An item with options like Size or Color (e.g., "T-Shirt" in S, M, L).
  • Digital/Service - Items that do not require physical shipping.
For Store Owners

Your product page is your "digital salesperson." Invest time in high-quality images and clear descriptions. These are the two biggest factors that convert browsing visitors into paying customers.

Products Overview​

The Products page provides a real-time snapshot of your inventory health and organization.

What You'll See​

When you navigate to Products, the main table displays:

  • Image - A visual thumbnail for quick identification.
  • Title - The official product name.
  • Status - Current visibility state (Active/Draft).
  • Variant - Complexity count (0 for simple, 1+ for items with options).
  • Category - Industry classification (e.g., "Food", "Apparel").
  • Vendor - The manufacturer or brand source.

What You Can Do​

From this page you can:

  • Search: Use the search bar to locate items instantly.
  • Filter: Use robust criteria to narrow down your view.
  • Sort: Reorganize the list by price, title, or stock.
  • Save Views: Create custom tabs for frequent tasks.
  • Create: Add new items to your catalog.

Quick Start Guide​

If you are adding your first product:

  1. Click Create - Click the button.
  2. Add Core Info - Enter a Title, Description, and upload Media.
  3. Set Status - Ensure the status is set to Active in the sidebar.
  4. Configure Price - In the Market and Pricing tab, set your selling price.
  5. Save - Click to publish.

Advanced Filtering​

As your inventory grows, finding specific subsets of products becomes critical. Soppiya provides a robust system that allows you to stack multiple criteria for precise results.

How to Apply Filters​

  1. Locate the button on the top right corner.
  2. A dropdown menu will appear with the following criteria:
    • Status: Filter by Active or Draft.
    • Tag: Filter by custom internal tags (e.g., "Fragile", "Summer_Sale").
    • Type: Filter by your custom product types (e.g., "Food", "Apparel").
    • Collection: Isolate products that belong to a specific virtual shelf.
    • Category: Filter by standard taxonomy categories.

Managing Active Filters​

  • Filter Chips: Once a filter is selected, it appears as a "chip" or tag at the top of the list.
  • Stacking: You can add multiple filters simultaneously (e.g., showing products that are BOTH Type: Food AND Status: Active).
  • Clearing Filters:
    • To remove a single criterion, click the X on the specific filter chip.
    • To reset the dashboard entirely, click the text.

Sorting Inventory​

The default view sorts by creation date, but you can reorganize the list to prioritize different data points.

  1. Click the icon located in the top-right corner toolbar.
  2. Select a primary sorting dimension from the list:
    • Id: System-generated unique identifier.
    • Status: Group items by their publication state.
    • Title: Alphabetical sorting (A-Z).
    • Type: Group items by their product definition.
    • Vendor: Group items by supplier.
    • Meta Data: Sort by SEO fields like Meta Title.
    • Options: Sort by variant options (Option 1, 2, or 3).
  3. Direction: At the bottom of the dropdown, toggle between Ascending (A-Z, 0-9) or Descending (Z-A, 9-0).

How to Create a Product​

To add a new item to your store:

  1. Navigate to Products.
  2. Click button.
  3. Complete the core information (Title and Description).
  4. Configure the settings detailed below.
  5. Click button.

Product Configuration​

Essential fields:

  • Title: The official product name.
  • Description: Compelling details using the Rich Text Editor.
  • Media: High-quality visuals (JPG, PNG, WEBP).
  • Status: Active or Draft.
View All Product Field Details

Organization & Media​

Product Category:

  • What it is: Standardized industry classification (e.g., "Electronics").
  • Best practice: Assign the most specific category to help with tax calculations.

Product Type:

  • What it is: Your custom internal label (e.g., "Sandal", "Smartwatch").

Product Vendor:

  • What it is: The manufacturer or brand source (e.g., "Apple", "Samsung").

Tags:

  • What it is: Internal keywords for searching/filtering (e.g., "Winter").

Media Sorting:

  • What it is: The first image is the "Main Thumbnail."
  • Best practice: Upload images with at least 512px resolution.

Logistics & Pricing (Basics Tab)​

This tab handles the physical properties and internal data for the SKU.

  • Status: Set the variant to Active, Archived, or Draft.
  • Media: Click Change to select a specific photo for this variant.
  • Measurements: Enter Length, Width, Height, and Weight.
note

Shipping Accuracy: Weight and dimensions are critical for carrier shipping rates.

  • Logistics:
    • Country of Origin: Required for international trade compliance.
    • HS Code: The Harmonized System code for customs.
    • Barcode: Enter UPC, EAN, or ISBN.
    • Cost per item: Your internal purchase cost (hidden from customers) to track profit margins.
  • Return Policy: Define the Return Window and Restocking fee.
  • Weight Requirement: Accurate weight is mandatory for carrier-calculated shipping.

Market and Pricing Tab​

This section handles localized pricing strategies.

  • SKU: Enter a unique Stock Keeping Unit identifier (e.g., TSHIRT-BLU-SM).
  • Price: The current selling price.
  • Compare at price: Original price to show a "Sale" strikethrough. If higher than Price, the item displays a "Sale" badge.
  • Fixed Price: Lock the price to prevent automatic currency changes.
  • Tax/Inventory Toggles:
    • Track inventory: Enable for physical goods to auto-deduct stock.
    • Continue selling when out of stock: Enable for pre-orders.
    • Charge tax on this product: Apply localized taxes.
  • Selling Quantity Rule:
    • Minimum: Lowest number of units per order.
    • Maximum: Purchase limit per customer.
    • Increment: Force customers to buy in bundles (e.g., 6).
  • Wholesale Logic: Set Price Breaks (e.g., "Buy 50+ units for $4.50 each").

SEO (Search Engine Listing)​

URL Handle:

  • What it is: The specific link (e.g., /products/summer-hoodie).
  • Best practice: Keep it short and descriptive.
  • ❌ Bad: /products/p-9912
  • ✅ Good: /products/blue-cotton-hoodie

Title & Meta Description:

  • Customize specifically for Google search results to improve click-through rates.

Product Variations vs. Variants​

It is important to distinguish between Variations (the attributes like Color or Size) and Variants (the actual sellable SKU that combines those attributes).

Defining Attributes (Variations)​

If your product is available in multiple types (e.g., different colors or sizes), use the Variations section.

  1. Simple Product: If no variations exist, the system defaults to "Using default variant."
  2. Variable Product: Click + Add options like color, size etc.
    • Option Name: Enter an attribute (e.g., Color). Press enter after each value.
    • Option Values: Enter specific values (e.g., Blue, Red).

The Variants Dashboard​

The Variants page serves as the control center for every specific SKU under a parent product.

  • List View: Displays all generated variants (e.g., "Blue, Small").
  • Add Variant: Click the button to manually create a new combination.
  • Configure: Click a specific variant row to open the detailed editor (Basics, Inventory, Market tabs).

Real World Examples​

Example 1: Wholesale Bundle (Quantity Rules)

Campaign Goal: Sell beverages only in full cases of 24.

Configuration:

FieldSetting
TitleOrganic Energy Drink
Minimum Qty24
Increment24
Price$2.00 (per unit)

Why this works: The "Increment" rule prevents customers from adding 25 or 30 items to their cart. They can only add 24, 48, 72, etc., ensuring your warehouse only picks full cases.

Example 2: Psychological Pricing (Compare At)

Campaign Goal: Run a clearance sale on old inventory.

Configuration:

FieldSetting
Price$45.00
Compare at Price$90.00
StatusActive

Why this works: The customer sees a "50% Off" indicator and a strikethrough price of $90.00. This creates a sense of urgency and value.

Managing Products​

Editing Products​

  1. Navigate to the Products dashboard.
  2. Search or Filter to find your item.
  3. Click the Title to open the editor.
  4. Apply changes and click .

Deleting Products​

  1. Open the product you wish to remove.
  2. Scroll to the bottom of the page.
  3. Click .
Permanent Action

Deleting a product is irreversible. It removes all associated variants, SEO data, and inventory history. To temporarily hide a product, use the Draft status instead.

Troubleshooting​

Why isn't my product showing up on the website?

Possible causes:

  • Product Status is set to "Draft."
  • The product is not assigned to the active "Market."
  • Inventory is 0 and "Continue selling when out of stock" is unchecked.

Solution: Check the sidebar status badge and the Market/Pricing tab to ensure the item is active and has stock.

I changed the price, but the website still shows the old one.

Possible causes:

  • Browser cache is showing an old version.
  • The price was changed in the "Basics" but not updated for specific "Markets."

Solution: Check your settings in the Market and Pricing tab. Also, try viewing your store in an Incognito/Private browser window.

Why can't I delete a specific variant?

Possible causes:

  • A product must have at least one variant.
  • The variant is currently linked to an active "Custom View."

Solution: If you want to remove all variants, you must delete the entire product. If you only have one variant left, the system will not allow you to delete it.

The "Compare at" price isn't showing a discount badge.

Possible causes:

  • The "Compare at" price is equal to or lower than the actual Price.

Solution: Ensure the "Compare at" price is significantly higher than the selling Price for the badge to trigger.

Need More Help?

If you're still experiencing issues, contact Soppiya support with the Product Title and a screenshot of your Market/Pricing configuration.

Best Practices​

Product Strategy Best Practices

Organization

  • Use Consistent Tags: Use tags like Summer24 or Bestseller to help customers filter your store efficiently.
  • Unique SKUs: Always assign a unique SKU to every variant to prevent shipping errors.

SEO & Marketing

  • Descriptive Handles: Never use the default ID as your URL handle. Use descriptive names like /products/blue-silk-tie.
  • Alt Text: Ensure your images have descriptive filenames (e.g., leather-boots-side-view.jpg) before uploading.

Common Mistakes to Avoid

  • ❌ Changing URL Handles: Changing a URL on a live product breaks old links from social media.
  • ❌ Missing Weights: Skipping the weight field will cause errors for customers at checkout if you use carrier shipping.
  • ❌ Blurry Media: Avoid using low-resolution thumbnails; it decreases customer trust.

Summary​

The Products module enables you to manage your catalog with precision, from basic descriptions to complex variant pricing. A well-maintained product database ensures accurate inventory, correct shipping calculations, and a professional shopping experience.

Key takeaways:

  • Filtering & Sorting: Use stacked filters and custom views to manage large inventories.
  • Weights: Mandatory for accurate shipping rates.
  • Variants: Track stock and pricing for different sizes or colors separately.
  • SEO: Customize your URL handles to rank higher on search engines.

Start by creating a simple "Draft" product today to familiarize yourself with the fields and tabs before building your full catalog.