On this page

SiteGUI Commerce uses the concept of product variants to support multiple models of the same product. A variant of a product maybe differ with another variant in color, size or price but share other characteristics. A product can have just a single variant or multiple ones, they are not really different, SiteGUI Commerce handles both products the same.

Creating a New Product Variant

Click on the New menu and choose Product to create a new product. At the first tab, you will be able to create the first product variant. Each variant can have multiple images, click on Add Image and use the Upload button to select images from the File Manager. If the images have not been uploaded, please create a folder in the current quarter folder (e.g: 2023Q2) to upload the variant images, a distinguished folder will help locating the image files easier when you edit the product later. After that, enter or scan the SKU number for the variant and set the price and the number of available stock. If the variant is a physical product that requires shipping, shipping weight and dimension can be entered by clicking on the Shipping property to help calculating shipping rates using weight and dimension. If the product does not require shipping or a flat shipping rate (not depending on the product's weight/dimension) will be charged, you can leave the Shipping property empty.

Once you have entered all the information for the first variant, you can click on Add Variant to add another variant. For your convenience, the second variant's information is duplicated from the first one so you just need to change where they are different. It is ok for a product to have just one single variant or have other properties/options such as Color, Size etc for its variants. New properties/options can be added to all the variants of a product by clicking on the Add Property button. Properties start with @ are hidden properties, they are not meant to be displayed but used for fulfillment operations. When customers browse the product on the website, all of the visible options will be shown and they will be able to choose exactly the properties/options they want.

Editing Product Content & Settings

Product content can be edited just like you edit a Page. Product content should contain product information, features, instructions etc and Featured Image should contain one picture that can represent the product. You may use the Recommended Products field to list other products that should be purchased together with the product.

In the Settings, you may choose a different layout for displaying your product, add it to one or more product collections and schedule a date that the product is available. You can assign a special tax rate to the product if you enable Tax and create special rates.

Products can be associated with an order processor which will run when the order for the product is accepted/processed. The order processor can do anything for the product such as creating an account or a tracking number etc. Order processor apps are available on the Appstore under the Fulfillment category. Products can set their order processor to run immediately when an order containing the product is paid by turning on Automatic Fulfillment for the product. Otherwise the order processor will not be triggered until the order is manually accepted.

If the product requires shipping and you want to add a surcharge or a discount to the then calculated shipping rate (at checkout time), you may enter a positive amount for surcharge and a negative amount for discount into the Shipping Surcharge/Discount field. If the product does not require shipping, please do not enter anything into the Shipping property or the Shipping Surcharge/Discount field otherwise a shipping fee may be added to the shopping cart during checkout.

Versioning

When a staff with no publish privilege tries to save an already-published-product , a new version of the product is cloned instead, allowing the staff to make changes to the cloned version without changing the published product. Later, the staff may choose Request Merge to request privileged staff to update the published product with their modified version. For privileged staff, they can replace the original version with any versions by choosing Replace The Original Version With This Version when viewing the choose version. Please note that versioning just clones the page content and variants only, it doesn't clone the relationship to the original page (menus, widgets etc). When updating, versioning will preserve original page's ID, variants' ID, slug, view, public data and relationships (menus, widgets). If the modified version has fewer variants than the original, a number of the original variants equal to the number of the modified product's variants will be replaced, and the remaining original variants will have their stock set to 0 to disable selling (these variants should not be removed as they could be linked to existing orders)

Managing Products

Clicking on Products in the App Listing menu will list all available products. Products can be created or cloned from an existing product by staff having Product::create permission and be published or deleted by staff having Product::publish permission. Published product cannot be saved by unauthorized staff, a cloned product is created in that case instead so modification can be made. The modified product can always be published to replace the original product later by an authorized staff.