A product represents any item for sale on a Kibo eCommerce site. The entire suite of products defined for a merchant is called a master catalog, which is shared across sites with individual catalogs.

Products can include:

  • An unlimited number of attributes, which uniquely describe the product
  • Images of the product to display on the storefront
  • Variations based on size, color, and other options

Products can also belong to one or more categories, which hierarchically classify products. Refer to Categories for more information about the different types of categories an using them to classify your products.Products

Before you create products, you must first complete the following steps:

  1. Create product attributes to define the characteristics of your products.
  2. Create product types that provide templates of settings and attributes for a specific set of products.

After creating your product attributes and product types, you can then create products to sell on your Kibo eCommerce storefront.

Product Variations

Product variations occur when a product includes configurable options that create distinct variations of the product. You create product variations when you create products that include configurable options.

For example, imagine that you sell the same glove in three different colors and twelve different sizes. Kibo eCommerce generates 36 distinct variations of the base glove product, one for each possible configuration of the glove.

This feature allows you to manage inventory for each variation while maintaining a single product definition, represented by a base product code.

Note:  You cannot create more than 5,000 product variations of a base product. If you need to create more than 5,000 product variations, Kibo eCommerce recommends creating a new base product and then creating further product variations off the new base product.

Product Variant Codes

When you generate variations for a product, Kibo eCommerce assigns each variant a unique product code that maintains an association with the base product code. Kibo eCommerce also generates a variation key that represents the option values that identify the product variant.

You can assign your own unique product codes for each product variant.

Important:  If you already have existing product codes for your variants, and you decide to add new options to your existing product variants, Kibo eCommerce does not keep your existing product codes for your variants. To avoid losing any product codes you created for product variants, Kibo eCommerce recommends to fully plan for all possible configurable options for your products before creating unique product codes for your product variants.


For example, if the product code for a base disposable gloves product is AAMV42100, when you generate a product variation to offer the glove with the options of light blue in size 7, Kibo eCommerce automatically assigns the following values based on the sequence of the variation and the selected option values:

  • Variation product code: AAMV42100
  • Variation key: AAMV42100-AAMV48100
Note:  The variation key is a field in the Kibo eCommerce API product variations object. You only need to take note of this field and its value if you’re using the Kibo eCommerce API to interact with product variants.
Tip:  You can navigate to product variants via URL using the following syntax: For example,

Product Variant Deviations

Each product variant can have a delta price or delta weight, which deviates from the base product definition.

For example, if the base price for the disposable gloves is $89.00 but you want to charge an extra $5 for gloves sizes greater than 10, you can define a delta price of $5 for each variant associated with size options greater than 10.

As another example, if the base weight of the gloves is two pounds, but gloves sizes under 7 weigh half a pound less, you can define a delta weight of -0.5 for each variant associated with size options less than 7.

Product Variants on Sites

When you create product variants, they appear on your site as configurable options that shoppers must configure. For example, you sell a size 7 disposable gloves in light blue on your site. In order for a shopper to order this product variant, they must first select the light blue color and also the size 7 on your site.

The base product itself doesn’t appear on your site, because it only exists for Kibo eCommerce to associate the product variants with. However, product variant details that do not deviate from the base product are shown on the site as part of the product variant, such as product properties and extras.

Tip:  If you want to hide product variants that are out of stock on your site, you can configure the base product to be hidden on the site when out of stock. Then, whenever a product variant associated with this base product becomes out of stock, you can either make the product variant unselectable or hidden on your site, depending on your theme.
Note:  Kibo eCommerce does not support hiding individual product variants on your site for temporary purposes other than when they are out of stock. If you want to hide product variants on your site temporarily, Kibo eCommerce recommends creating a separate base product with its own product variants , and configuring the active start and end dates of the base product.

Product Variant Pricing and Weight

You can specify the pricing mode for your products, which controls how you specify the price and weight of product variants.
Products support the following pricing modes:

  • Relative—allows you to reference the variant pricing and weight off of the base product, and specify a delta value for each.
    For example, if the base price for a disposable gloves is $89.00 but you want to charge an extra $5 for gloves sizes greater than 10, you can define a delta price of $5 for each variant associated with size options greater than 10.
  • Explicit—allows you to explicitly define the pricing and weight for the product variant, completely separate from the base product.
    For example, you want to charge exactly $65.99 for a specialty color disposable gloves, regardless of the base price for the disposable gloves.
Note:  If you do not specify either a relative or explicit price for each variant, the variant’s price and weight will be the same as the base product’s.Use the Pricing Mode drop-down menu on the base product’s Options section to specify the pricing mode for your product variants:

Create Products

Once you create product attributes and product types you can then create your products to sell on your storefront. When you create products you can also choose to create product variations if your product includes configurable options.

To create a new product:

    1. Go to Main > Catalog > Products.
    2. Select the catalog you wish to add the product to in the Catalog list.
      Note:  Ensure that you have the correct catalog selected, because once you add a product to a catalog you cannot move that product to another catalog that belongs to another master catalog. You can move products between catalogs under the same master catalog.
    3. Click Create New Product.
    4. In the General section, add the following:
      1. Code
        The Product Code must be at least three characters.
      2. Status
        The Status field allows you to schedule the product to be active during a specific time-frame on your storefront.
      3. Product Type
      4. Product Usage
      5. Name
      6. Short Description
        The Short Description field has a 260 character limit.
      7. Full Description
      8. Product Image
      9. Pricing Information
      10. First Available Date
        The First Available Date field allows you to specify the date the product either becomes or became first available in the specific catalog. Refer to First Available Date for more information about this field.
    5. In the Inventory section, you can track stock level and you can determine the behavior when the product goes out of stock. When you product goes out of stock, you can opt to show an out of stock message, allow backordering, or hide product in store.
      If you decide to track inventory for a product, refer to Inventory Management for information Also refer to Out of Stock Behaviors for more information about the out of stock behavior settings.

      Note:  You must configure one or more locations for the Inventory section to appear. Refer to Location Settings for more information about configuring locations.
    6. Depending on what you selected for Product Usage, you will have option, property, and extra values to enter.
      Refer to Product Attributes for more information about assigning atribute values to a product.

      Tip:  If your product includes options, in the Options section select a Pricing Mode and click Select Values to edit the product’s variants. In the Edit Variants window, click Update Options to create a product variation and click the Enabled checkbox next to each variant you want to enable. Refer to Product Variant Pricing for more information about product variant pricing.
    7. In the Shipping section, select whether the product is direct ship, in-store pick up, or both. You also add weight and package dimensions in this section.
    8. In the Categories section, select the static categories of which the product is a member.
      You can also create dynamic categories to automatically add products to depending on specific configuration options. Refer to Dynamic Categories for more information.

      Note:  You must first create static categories before you can assign products to the static category. Refer to Static Categories for more information.
      Tip:  If you assign a product to more than one static category, you can use the Primary Category field to specify which static category to use in the navigation breadcrumb, regardless of how shoppers navigate to the product. If not set, or if the product belongs only to dynamic categories, the default is to use the category with the smallest ID.
  1. In the SEO section, use the available fields to enter SEO information:
    Field NameSEO Effect
    Meta TitleMaps to the HTML meta title tag. While most search engines place little value on this tag, most Kibo eCommerce themes inject the value of the meta title tag into the HTML title tag. The HTML title tag is used by search engines and browsers to display the title of the page, and is critical to SEO. Search engines place very high importance on the correlation between a page's title tag and its content.
    SlugThe default URL structure for products is{slug}/p/{productCode} and for categories is{slug}/c/{categoryId}. The slug (or SEO-friendly URL) gives you the ability to add a meaningful component to the URL structure in order to boost search results.
    Meta DescriptionMaps to the HTML meta description tag, which is used by search engines to summarize the content of the page.
    Meta KeywordsMaps to the HTML meta keywords tag, which is used to tell search engines what the page is about. From an SEO-perspective, search engines place little value on this tag, but the Kibo eCommerce search implementation uses these keywords to help construct search results for pages on your storefront.
  2. Depending on your Product Publishing settings, you can either have the product publish immediately or become a product draft:
    • If your Product Publishing settings are set to Live, click Save to make the product live on your storefront.
    • If your Product Publishing settings are set to Staged, click Save to save your changes, and then decide to either publish the product draft immediately, or move it to a Publish Set. Refer to Publishing Overview for more information about publishing products.

First Available Date

The First Available Date field allows you to specify the date the product either becomes or became first available in the specific catalog.

Note:  If you do not specify a value for this field, Kibo eCommerce defaults the value of this field to the date when you add the product to a catalog.

Kibo eCommerce uses the value of this field to calculate the number of days the product has been in the catalog. You can then use this value in the Days available in catalog dynamic category expression field to target products that have been in your catalog for a specific number of days. Refer to Dynamic Category Expression Fields for more information about using the Days available in catalog field in a dynamic category expression.

Add Products to Catalogs

If you’ve already created a product but you need it to be in an additional or another catalog, you can easily add it to the catalog.

You add products to catalogs using the product details:

    1. Go to Main > Catalog > Products.
    2. Select your product.
    3. In the Catalogs list, click the Edit button to add your product to a specific catalog.

Tip:  If you want to change the product’s details for a specific catalog such as price or descriptions, select that catalog’s tab and check Override global.

Was this article helpful?

Related Articles

Leave A Comment?