Skip to main content

Storefront Products

What it is​

Create and manage products in your storefront catalog

Who it's for​

Workspace Owner Staff

Access & Scope​

PropertyValue
Modulestorefront
Personasworkspace-owner, staff
ScopeWorkspace-level
UI LocationDashboard > Storefront > Products

| Status | active |

UI Location​

Dashboard > Storefront > Products

How it works​

The Storefront Products feature enables you to create and manage products in your online store. Here's how it works:

  1. Product Creation:

    • Create products with name, description, and base price
    • Assign products to categories
    • Set product status (active or archived)
    • Configure product slug (URL identifier)

  2. Product Images:

    • Upload multiple images per product
    • Reorder images to control display order
    • Delete individual images
    • First image is typically used as the primary/thumbnail image

  3. Product Videos:

    • Upload product videos (MP4, WebM, QuickTime, AVI)
    • Or provide external video URL
    • Videos are displayed on product pages

  4. Product Options (Variants):

    • Create option groups (e.g., Size, Color, Material)
    • Each group can have multiple items (e.g., Small, Medium, Large)
    • Configure selection type: single or multiple
    • Set required/optional status
    • Define min/max selections for multiple-choice groups
    • Each option item can have:
      • Name
      • Price delta (additional cost or discount)
      • Default selection status
      • Custom image
      • Sort order

  5. Product Attributes:

    • Add specifications (e.g., Weight, Dimensions)
    • Add extra fields (custom attributes)
    • Each attribute has name and value

  6. Product Discounts:

    • Configure percentage or fixed amount discounts
    • Set discount start and end dates
    • Enable/disable discounts
    • Discounts are automatically calculated and displayed

  7. Product Organization:

    • Assign products to categories
    • Set product sort order within categories
    • Archive products to hide them without deleting

  8. Product SEO:

    • Configure SEO settings per product
    • Meta title, description, keywords
    • Open Graph and Twitter Card images
    • Optimize product pages for search engines

  9. QR Codes:

    • Generate QR codes for individual products
    • Share products easily via QR codes

Settings​

The Storefront Products feature includes the following configuration options:

  1. Product Basic Settings:

    • Product name (max 160 characters)
    • Product description (rich text)
    • Base price (must be 0 or greater)
    • Category assignment
    • Product slug (auto-generated from name, can be edited)
    • Status (active/archived)

  2. Image Settings:

    • Multiple images per product
    • Image reordering
    • Image deletion
    • File size limit: 5MB per image
    • Supported formats: Standard image formats

  3. Video Settings:

    • Upload video file (100MB limit)
    • Or provide external video URL (max 800 characters)
    • Supported formats: MP4, WebM, QuickTime, AVI

  4. Option Group Settings:

    • Group name
    • Selection type (single or multiple)
    • Required/optional status
    • Min/max selections (for multiple-choice)
    • Sort order

  5. Option Item Settings:

    • Item name
    • Price delta (can be positive or negative)
    • Default selection
    • Custom image upload
    • Sort order

  6. Discount Settings:

    • Discount type (percentage or fixed)
    • Discount value
    • Active/inactive status
    • Start date/time
    • End date/time

  7. Attribute Settings:

    • Attribute name
    • Attribute value
    • Sort order

  8. SEO Settings (per product):

    • Meta title (max 60 characters)
    • Meta description (max 160 characters)
    • Meta keywords (max 255 characters)
    • Open Graph title, description, image
    • Twitter Card type, title, description, image

Permissions​

Access to Storefront Products requires:

  • store.manage: Required to view, create, edit, and delete products

Default Access:

  • Workspace Owner: Has full access to all product management features
  • Staff: Access depends on assigned role permissions. Staff without store.manage cannot access products.

Use Cases​

  1. Physical Products:

    • Create products with images and descriptions
    • Use options for sizes, colors, or variants
    • Set prices and manage inventory through options

  2. Digital Products:

    • Create downloadable products
    • Use options for different formats or licenses
    • Set pricing tiers

  3. Services:

    • Represent services as products
    • Use options for service packages or add-ons
    • Configure pricing for different service levels

  4. Product Variants:

    • Use option groups to create product variants
    • Example: T-shirt with Size (S, M, L) and Color (Red, Blue, Green)
    • Each combination can have different pricing

  5. Product Bundles:

    • Create products with multiple option groups
    • Allow customers to select multiple options
    • Price adjustments based on selected options

  6. Promotional Products:

    • Use discounts for sales and promotions
    • Set time-limited discounts
    • Display discounted prices prominently

  7. Product Organization:

    • Organize products into categories
    • Control product display order
    • Archive old products while preserving data

Notes / Limits​

  1. Product Name: Maximum 160 characters

  2. Product Slug:

    • Auto-generated from product name
    • Can be manually edited
    • Must be unique within the store
    • Used in product URL

  3. Base Price:

    • Must be 0 or greater
    • Supports 2 decimal places
    • Final price = base price + option price deltas - discount

  4. Product Images:

    • Maximum file size: 5MB per image
    • Multiple images supported
    • Images can be reordered
    • First image typically used as thumbnail

  5. Product Videos:

    • Maximum file size: 100MB
    • Supported formats: MP4, WebM, QuickTime, AVI
    • External video URLs: Maximum 800 characters

  6. Option Groups:

    • Multiple option groups per product
    • Each group can have multiple items
    • Price deltas can be positive (add cost) or negative (discount)

  7. Discounts:

    • Percentage discounts: 0-100%
    • Fixed discounts: Any positive amount
    • End date must be after start date
    • Discounts are calculated on base price + option deltas

  8. Product Status:

    • Active: Visible in storefront
    • Archived: Hidden from storefront but data preserved

  9. Sorting: Products can be sorted by newest, price (ascending/descending), or name

  10. Performance: Large numbers of products may impact loading times. Consider pagination and filtering for optimal performance.

Changelog​

Mon Jan 15 2024 02:00:00 GMT+0200 (Eastern European Standard Time)​

  • Initial documentation