page last edited on 25 November 2017
- Video guide
- Adding a new product
- Basic product setup
- Advanced product setup
- Set advanced inventory tracking options for the product (low stock threshold and notifications)
- Specify additional product parameters to be shown in the product specification
- Specify product options for buyers to choose
- Set wholesale prices and minimum purchase quantities for different membership levels
- Sell the product on eBay
- Link the product to other products in the store so they are shown as related to this product
- Change the set of tabs displayed on the product page in the Customer area
- Add PIN codes to the product
- Attach files to the product
This video captures the process of adding a new product in X-Cart 5.3.x.
Adding a new product
This section provides information on how to add products to your store manually one by one. Please note that you can also add products via import.
To add a new product:
In your store’s Admin area, go to the Products section (Catalog > Products).
Click the Add product button.
The Add product page opens.
Use the fields on the Add product page to provide information about the product. The page contains quite a number of fields, but you do not have to set all of them right now: the only required field is Product name, which means you only have to provide that value, whereas the rest of the product fields may be configured at any time later. See the section “Basic product setup” below for a detailed explanation of all the product page fields.
To save the product information you have provided, click Add product at the bottom of the page. The new product will be saved. If necessary, you will be able to find it in the Products section (Catalog > Products) to do further editing or to specify some advanced product settings (See the section “Advanced product setup” section of this manual for more info).
Basic product setup
When creating a new product, you need to specify product information via the form fields of the Add product page. Note that the actual set of fields available to you on this page depends on the X-Cart edition you are using and the set of addons (modules) enabled. The following list of fields corresponds to the set of product fields available for configuration on a fresh install of X-Cart Ultimate edition. If you do not see any of the fields described below in your X-Cart store back end, it means that the addon that enables this field is not installed or not active. To see what addons are active in your store and, if necessary, to install/activate more addons, check the My addons section in your X-Cart store Admin area. More info on the management of X-Cart addons can be found in the Managing addons section of this manual.
So, here is the product information that can be specified when adding a new product:
Vendor: Company name and email of the vendor who owns the product. This field is only available if X-Cart’s Multi-vendor addon is active. Since an administrator can create products not only for themselves, but also for other users (vendors), this field needs to be adjusted to specify the owner of the product.
Product name: The name by which you and your customers will identify this product.
SKU: The product SKU (A code that will serve as a unique identifier for this product). If you leave this field blank, a SKU will be generated automatically when the product is saved.
Images: Use this section to add images of the product.
Category: The category (or categories) to which this product belongs.
Description: A short product description that will be displayed on product list pages.
Full description: A longer product description that will be displayed on the product details page.
Allow buyers to attach files to this product: This field is only available if X-Cart’s “Customer Files Uploads & Product Attachments” addon is active.
Tags: This field is only available if X-Cart’s Product Tags addon is active; it enables you to assign tags defined via the Product tags section (Catalog > Tags) to the current product.
Available for sale: Whether the product should be displayed on the storefront. Uncheck this option to temporarily remove the product from the storefront (Store visitors will not be able to see it).
If you disable the Available for sale option, the product will become inactive, and store visitors who will attempt to access the page of this product via a direct link will see the 404 “Page not found” error. If necessary, you can set redirects for the pages of disabled products using .htacces or the Redirects Module.
If you don’t want to sell a product any longer but want a product page be still accessible on the storefront, set the product’s stock to zero and add “Not available for sale” to the product name, rather than making it inactive. Make sure the How to show out of stock products option is set to “Show in all the sections” in the Store setup -> Cart & checkout section of the admin area.
Call for price: This field is only available if X-Cart’s Call For Price addon is active; it enables you to specify that the price and Add to cart button must not be provided for the current product; instead, a message inviting store visitors to call for price should be displayed.
Prices & Inventory
Memberships: Membership levels to which this product should be available. Non-members and users belonging to other membership levels will not be able to see the product on the storefront. For more info on memberships in X-Cart, see the section User membership levels of this manual.
Tax class: The tax class to which the product belongs (Defines what taxes should be applied to the product). For more info on tax classes, see: Setting up tax classes.
Price: The product base price.
Market price: This field is enabled by the Market Price addon. It can be used to set a market product price showing the difference between the product price offered in your store and the average price of this product on the market. The market price is meant to show a customer how advantageous it is to order the product from your store. The market price is displayed next to the regular one on the product details page and in the product listing within a category. A sign showing the discount produced by the price difference is shown next to it to draw the attention of your site visitors.
Sale: This field is enabled by the Sale addon. Use it to put the product on sale. After enabling the “Sale” option you will be able to specify either a sale price for the product (expressed in the store currency) or a discount (expressed as a percentage off the product base price).
Arrival date: This field allows you to record the date since when the product is or will be available in your store. On its own, the information entered in this field serves purely informational purposes, but may be employed by X-Cart modules (For example, a module that allows you to add a new product to your catalog in advance and let it be published on the storefront automatically when its arrival date is reached).
Automatic reward points: This field is only available if X-Cart’s Loyalty Program addon is active; it enables you to specify whether reward points for buying the current product should be calculated from the product price automatically or adjusted manually. With the “Automatic reward points” option disabled you will be able to set the number of points that a customer will earn by buying the current product via the Reward points field (appears when the “Automatic reward points” option is enabled).
Inventory tracking: Whether you wish to use the inventory tracking feature for this product. The inventory tracking feature enables you to specify the number of product units you have on hand initially (using the “Quantity in stock” field; see below); your X-Cart store will then track all the purchases of the product. Every time someone buys the product, the number in the “Quantity in stock” field will be reduced automatically by the number of units that have been purchased. If you have a stock refill, you edit the value in the “Quantity in stock” field increasing the value by the number of units you require. As a result, you will be able to tell how many units of the product you have in stock at any time. If the product quantity is unlimited and does not need to be tracked, the inventory tracking feature can be disabled.
Quantity in stock: The current inventory level of the product (the number of product units in stock). The value specified in this field is used for the Inventory tracking feature.
Available for backorder: This field is only available if X-Cart’s Backorder / Preorder addon is active; it enables you to specify that the current product can be purchased even when it is out of stock. After enabling the “Available for backorder” option, you will also be able to set a backorder label for the product and to limit the backorder quantity (see below).
Backorder label: This field is only available if the previous setting (“Available for backorder”) is enabled. It allows you to add a message regarding the backordering of the current product which your store visitors will see attached to this product in product lists and on the product page when the product is out of stock. You can insert the number of units available for backordering into this message by using the “%number%” placeholder; for example: “You can backorder up to %number% items.”
Limit the backorder quantity: This field is only available if the setting “Available for backorder” is enabled. It allows you to specify that only a limited number of units of the current product can be purchased on backorder, and to specify the maximum limit via the Max. backorder quantity field (appears when the “Limit the backorder quantity” option is enabled).
Weight: Product weight. If the product requires shipping, this setting may affect the calculation of order shipping cost.
Requires shipping: Whether this product requires shipping. This setting affects the calculation of order shipping cost. (If the product does not require shipping, the shipping cost for it will not be calculated).
Exclude from shipping cost calculation: This field is enabled by the addon Free shipping and Shipping freights. More info on using this setting is available in the section Free shipping on specific products.
Separate box: Whether the product needs to be shipped separately from other products. If it needs to be shipped in a separate box, you can define the box dimensions and the maximum number of product units that fit in this box. This setting affects the calculation of order shipping cost.
Open Graph meta tags: The custom META tags for sharing the product page on Facebook.
Meta description: The description to be used in the description META tag on the product page (for SEO purposes).
Meta keywords: The keywords to be used in the keywords META tag on the product page (for SEO purposes).
Product page title: The title to be used in the title bar of this product details page (for SEO purposes).
Clean URL: The product page Clean URL (human-readable SEO-friendly URL, typically based on the product name). The URL can be configured manually (by editing of the field contents directly) or generated automatically (by enabling the “Autogenerate Clean URL” option below before saving the product). Note that if the Clean URLs feature is disabled, you will need to activate it for the SEO-friendly page URLs to become available to store visitors. More info on Clean URLs is available via the Setting up seo-friendly URLs section of this manual.
Advanced product setup
Once a new product has been added to your store, you can edit any of its settings configured during the [basic product setup] and, if necessary, configure some advanced product settings for it as well. To do so, you will need to find the product in the store’s Admin area (Catalog > Products) and click on the product name to access the product details. The result will be a page with all the information you have provided regarding this product so far - basically, the same page with the product information form you have completed during the basic product setup - but now this page will have tabs allowing you to access some additional sections for product configuration.
The set of tabs that will be available to you will depend on your X-Cart edition and the set of addons activated in your store. Below is an overview of some of the popular tasks that can be accomplished by adjusting the advanced product settings via the various tabs of the product page - with information on what X-Cart addons/features you will require.
Set advanced inventory tracking options for the product (low stock threshold and notifications)
Whereas it is possible to adjust some basic product inventory tracking settings via the Prices & Inventory section of the Info tab of the product details, you can access still more settings via the “Inventory tracking” tab:
Here you see the fields Arrival date, Inventory tracking and Quantity in stock (the same ones as in the Prices & Inventory section of the Info tab).
In addition, here are some settings you can use to set a low stock threshold for the product and get notified whenever the product stock goes down to this level. The settings are as follows:
Show low stock warning on product page: Enable this setting if you want a warning message (like “Only X left in stock”) to be displayed to customers viewing the product if the product stock reaches the low stock treshold.
To enable the warning, you will also need to specify the inventory level at which the warning should be triggered (Use the “Low limit quantity” field further below in this section).
You can edit the text of the warning message by editing the text label “Only X left in stock” via the Language labels section (Store setup > Translations). For information on text labels and how to edit them, see Managing texts labels in your store.
Notify administrator if the stock quantity of this product goes below a certain limit: Enable this setting to get an automated email notification when the product stock reaches the low stock treshold. You will also need to specify the inventory level at which the email notification needs to be sent (Use the “Low limit quantity” field below).
Low limit quantity: Use this field to set the low stock threshold for the product (starting from this quantity, the product stock level will be considered “low”).
Specify additional product parameters to be shown in the product specification
If you want to specify additional parameters (like color, material, country of origin, ISBN, etc.) for the product so they can be viewed by your store visitors on the “Specification” tab of the product page, you will want to use X-Cart’s Product classes and attributes feature. This feature is part of X-Cart’s core and, if you just want the attributes, does not require any X-Cart addons. The attributes can be specified via the “Attributes” tab of the product page.
Specify product options for buyers to choose
If you want to configure product options (color, size, etc.) so buyers will be able to choose the options they require before checkout, you will need to use X-Cart’s Product classes and attributes feature. This feature helps you to configure options for the product via the “Attributes” tab of the product page.
For example, you will be able to create an attribute “Size” and to specify multiple attribute values for it like “XS”, “S”, “M”, “L” and “XL”. Your customers will be able to choose these values as product options.
If you need not just separate independent options, but product variants based on option combinations (like “Color: White + Size: XL”), you will need to use the addon Product Variants. This addon will help you to create product variants based on combinations of options that have been configured as attribute values. The configuration of product variants will have to be done via the “Variants” tab of the product page.
For more info on using the addon, see Product Variants
Set wholesale prices and minimum purchase quantities for different membership levels
If you want to set different prices on the same product that would be enabled for buyers depending on the buyer membership level and the product quantity being ordered, you should use the addon Wholesale.
With this addon you will be able to set price tiers for different purchase quantities and different user membership levels via the “Wholesale pricing” tab of the product page.
You will also be able to set minimum product purchase quantities for different user membership levels via the “Inventory tracking” tab.
For more info on using the addon, see Wholesale module.
Sell the product on eBay
To list the product on eBay and get your data synchronized between eBay and your X-Cart store, you may want to use the addon X-Cart eBay Integration. With this addon, you will be able to set the product’s eBay options via the “eBay product options” tab of the product page.
For more info on using the addon, see X-Cart eBay Integration.
Link the product to other products in the store so they are shown as related to this product
For cross-selling/upselling purposes, you may wish to create links from the current product to some other products in your store. These products will be displayed as related to the current product in the “Related products” block on the product page on the storefront and, if necessary, may be used as a source of “Customers who bought this also bought” recommendations in the Add to cart popup.
Linking products to one another is enabled by the addon Related Products. With this addon, you will be able to add links to related products for any product in your store via the “Related products” tab of the product page: For more info on using the addon, see Related Products.
Change the set of tabs displayed on the product page in the Customer area
X-Cart uses the Product tabs feature to present the detailed product info to the customers in the most suitable format.
The set of product tabs displayed to a customer is defined in the Tabs tab:
The product tabs can be global (applied to all exisiting products in the Catalogue -> Product tabs section) and product specific (applied to a particular product in the Tabs tab of the product details page).
To create a product specific product tab click the New tab button and fill in the tab name, content and brief info (if applicable) on the page that opens.
Click Create to add a product tab and stay on the product tab page or Save and close to add a product tab and be redirected back to the Tabs tab of the product details page.
Global product tabs are managed in the Catalogue -> Product tabs section:
The default global product tabs are:
- Description : Shows the product SKU, weight and detailed product description
- Specification : Shows the info about all available product options and attributes
- Comments : Shows the customer comments on a product added via special modules (Go social, Disqus, VK comments, etc.)
- Reviews : Shows an average rating of a product if it was rated and customer reviews (if any).
The default global product tabs can’t be deleted and can only be hidden if required. The rest of the tabs are added by the Custom Product Tabs module and can be enabled, disabled and deleted if necessary.
Add PIN codes to the product
If you need to sell stuff like licenses, enrollment keys, PIN codes, serial numbers, activation codes and passwords, phone cards and access codes, you may want to use the addon PIN Codes. This addon will enable you to attach PIN codes to your existing product via the “PIN codes” tab: For more info on using the addon, see PIN Codes Module.
Attach files to the product
If you need to attach files to your product (like a product manual or a detailed description) so your store visitors will be able to download these files from the product page, you will need to use the addon File attachments and the “Attachments” tab of the product page.
For more info on using the addon, see Product File Attachments.
If you need to be able not just to attach files for free download by store visitors but to sell digital goods, you will also need the addon E-goods. For more info on using the addon, see the section E-goods in this manual.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.