TrainingUser Guide


Web Store Getting Started

This document provides you with a basic overview of the LightSpeed Web Store, and includes summarized chronological steps on installation and configuration of an essential setup procedure. It is meant as the primary document to a Web Store setup, and a complementary resource to the Web Store articles, where detailed explanations of configuration of specific settings, such as shipping carriers, can be found.

A Note About Shipping

Like LightSpeed, Web Store charges shipping via a non-inventoried Product. Even though this shipping "Product" does not appear when the shopper is submitting their Web Order online, any shipping charges applied to the Web Order will be added once the Web Order is downloaded into LightSpeed. As explained below, each Shipping Method enabled in the Web Store must be associated with a non-inventoried Product created in LightSpeed to represent shipping/freight. 

Configure Web Store

Configuration of the Web Store is centralized to the Web Store Setup panel in LightSpeed (Tools > Web Store > Setup), which is where you will enter your web host info, and access the various configuration windows you’ll need for setup. Again, this guide outlines a summary of the requirements for a basic Web Store configuration in chronological order. For more information, please see the various articles on each step of the Web Store process, including the Web Store Installation article. 

A. Enter Host and Setup information   (link)

Within LightSpeed, you must enter the basic host information in the Web Store setup panel (Tools > Web Store > Setup). Enter the URL of your web host’s store location, and password. If you are hosted with Xsilva, you will receive this information from Xsilva Support. If you are hosting with a third party, they will provide you with this information. 

Adding Host and Setup Info

B. Confirm initial LightSpeed settings

Before you can complete a Web Store setup, you should confirm the following LightSpeed settings and make sure they have been properly configured. For information on how to configure these settings, please consult the LightSpeed Getting Started Guide, except where otherwise specified. 

Tax Code - The Tax Code(s) you set up in LightSpeed applies a particular combination of tax rates that you configure for different sales situations. The default Tax Code is the setting that is automatically applied to new documents, per sales station, and can be changed to any other Tax Codes you have added. These Tax Codes will be uploaded to the Web Store you can assign them to specific destinations, allowing them to automatically be applied to your Web Orders based on the shipping address.  

Default Currency - You must first define your default currency prior to updating the Web Store. 

Size-Color Matrix settings - Any Product you wish your shoppers to be able to choose using the pop-up menus for size and color must first be created using the Size-Color Matrix feature in LightSpeed. 

Families - This setting is only required if you want Families to be included with your Web Categories, the system of nested classification that allows your shoppers to drill down to the category of Product they’re looking for. 

C. Update Web Store to register initial settings   (link)

Before you can configure the Web Store, you must update the Web Store to register the settings described above. No Products or Documents will be added, but information regarding Tax Codes, Currency, and more will be communicated to the web host and become accessible in the Web Store Admin panel for the configurations described below. Go to (Tools > Web Store > Setup), and click Update Store.

Update Web Store

D. Configure Web Store Admin Panel

The Web Store Admin panel is a web-based interface accessed within LightSpeed that allows you to configure how your Web Store looks and behaves, including localized requirements, shipping and payment methods, and more. Outlined below are brief summaries of the essential configuration of the Web Store, and how to perform each one. Further information can be found in the Web Store articles linked within each step.

Web Store Admin Panel

1. Set Your Store and Localization Information   (link)

Tools > Web Store > Admin Panel > Configuration > Store

Store Name - the name that appears at the top of each screen the customer browses in your Web Store 

Store Phone - the primary contact telephone number for your retail location, displayed in the email footer

Store Email - the email address that appears in the Contact Us section of your web store, and from which address emails are sent

Default Language - the language you wish your web store to appear in. The default is English. However, it is possible to customize your store to operate in other languages using external solutions.

Locale - sets the location and language for the Web Store. For example, an English store in England would require “en_GB” (minus quotations) to be entered. Common locales would include:

en_CA - Canada

en_US - United States

en_AU - Australia

en_GB - United Kingdom

Default Country - the country where the order will be fulfilled from. This setting is used in the shipping calculations. 

Date Format - the date format as it will appear on correspondence with the customer

Web Store Time Zone - the international time zone from which the order will be fulfilled (contact Xsilva if this is different than your store’s time zone)

Tax-Inclusive Pricing - enabling this displays your web prices with the default Tax Code already applied. This setting should only be applied if you are using tax-inclusive pricing within LightSpeed. 

Default Currency - this sets the currency your prices appear in, and should reflect the Default Currency in LightSpeed. 

Currency Printing Format - sets the formatting for your currency, the %n default is pre-populated and will work in almost all situations. 

Browser Encoding - sets what special characters can be seen in your web store, dependant on language (normal setting is UTF-8)

Next Order ID - sets the next Web Orer ID number, in a similar fashion to the way ID numbers work in LightSpeed. 

Store and Localization Info



2. Add a Header Image to Brand Your Store

Tools > Web Store > Admin Panel > Configuration > Appearance

Header Image - add a header image to your Web Store by uploading the image to your web host, and then outlining the path where the image can be found as being either on your web host or with a full URL for the image online. The maximum dimensions of this image are 748 pixels wide by 111 pixels high. If you are hosting with Xsilva, you can send your header image to support@xsilva.com.

Header Image



3. Set Your Customer Preferences

Tools > Web Store > Admin Panel > Configuration > Store

Allow Guest Checkout - enables the ability for non-registered customers to process orders

Minimum Password Length - sets the minimum number of characters required for the customer log-in password

Phone Types - enter the options possible for customer telephone numbers, separated by commas and no spaces, including “work”, “home”, “mobile”, etc.  These choices will appear in a pop-up menu when the shopper is registering. 

Customer Preferences



4. Set Your Product Preferences

Tools > Web Store > Admin Panel > Configuration > Appearance

Product Color Label - the term used to indicate the product’s color

Product Size Label - the term used to indicate the product’s size

Products Per Page - sets the default number of products that appear per page on the web store

Product Sorting - sets the default sort mode for your products as they appear on your Web Store, including Product Name, Product Code, Price, or Inventory

Enable Families - enables the inclusion of LightSpeed Families in the list of Web Categories in the Web Store

Product Preferences



5. Set Your Product Image Preferences

Tools > Web Store > Admin Panel > Configuration > Appearance

Show Lightbox in Product Detail Page - enabling this feature opens a preview version of the primary image in its own window when the primary image is clicked

Image Store Location - allows you to indicate where the images are stored for your products, whether it’s in the database or in a separate file system on the web server.


6. Set Your Inventory Preferences

Tools > Web Store > Admin Panel > Configuration > Appearance

Display Inventory - enabled, this feature shows your customers  basic information about the inventory levels of your products

Display Inventory Level - enabled, this feature will display a general message (defined below) regarding your inventory levels, whether a product is available, not available, low, or not stocked. If this feature is disabled, but Display Inventory is enabled, the quantity of your available stock as of the last store update will be displayed. 

Use Total Inventory Count - enables the display of Total inventory quantities, not just Available Inventory quantities, including quantities Reserved and in Warehouses.

Zero or Negative Inventory Message - the message that is displayed when a product has no inventory, or is in negative quantities

Available Inventory Message - the message that is displayed when there is available inventory with a quantity more than the Low Inventory Threshold defined below

Low Inventory Message - the message that is displayed when a product has “low” inventory as definied by the Low Inventory Threshold below

Low Inventory Threshold - the point at which the Low Inventory Message is displayed. Does not affect Reorder Point in LightSpeed.

Non Stocked Item Display Message - enables the indication of Products that are attributed as “non-inventoried” in LightSpeed, such as “Labor”

Allow Out-of-Stock Products To Be Added to Cart - allows Products that have no quantities to be added to the Cart and purchased

Inventory Preferences



7. Set Your Payment Methods   (link)

Tools > Web Store > Admin Panel > Payment Methods

Each Payment Method in the Web Store must be linked to an existing Payment Method in LightSpeed. For example, if you have enabled "Purchase Order" as a payment method in Web Store, you must enter "Purchase Order" in the LightSpeed Payment Method field of the Admin panel (provided this is what it is called in LightSpeed). This text match must be exact and is case-sensitive.

Credit card payment methods require an account to be set up with the appropriate provider - Authorize.net, WorldPay, Beanstream, eWay, and/or PayPal. When setting up an Authorize.net account, you must specify that it needs to be a Retail Card-Not-Present account. Payment gateways on the Web Store can each be linked to their own Payment Method within LightSpeed, or all to a more general "Credit Card" Payment Method. Only those gateways with whom you arrange an account need to be configured in the Web Store. Please see the Web Store 2.0 document for more information on setting up gateway accounts.

In the Credit Card Types tab, you are able to restrict which types of credits cards with which the customer can pay, and the order in which they appear.

Authorize.net Simple Integration - this payment method directs shoppers to the Authorize.net set to process their encrypted, online payment, and then returns them back to the LightSpeed Web Store when completed.

Authorize.net Complex Integration - this payment method allows the shopper to remain in the LightSpeed Web Store while they process their encrypted Authorize.net payment.

WorldPay - adds "WorldPay" as a choice of payment on the payment screen, sending the shopper to the WorldPay site to process their encrypted payment, and returning them to the LightSpeed Web Store when completed

PayPal - adds "PayPal" as a choice of payment on the payment screen, sending the shopper to the PayPal site to process their encrypted payment, and returning them to the LightSpeed Web Store when completed.

Purchase Order - allows your shopper to enter a PO number as their payment when checking out. No credit card information is required.

Phone Order - allows you to indicate a telephone number your customer can call with their credit card for processing payment. No credit card information is required.

Cheque - allows your shopper to enter a cheque number as their payment when checking out, as well as you to tell your customer to what address to send the cheque. No credit card information is required.

Cash on Delivery - allows your shopper to check out without any payment information. No credit card information is required.

Beanstream - allows Canadian or American merchants to accept credit card payments from shoppers. This payment method allows the shopper to remain in the LightSpeed Web Store while they process their encrypted Beanstream payment.

eWay - allows Australian shoppers to accept credit card payments from shoppers. This payment method allows the shopper to remain in the LightSpeed Web Store while they process their encrypted eWay payment.

Payment Methods

Payment Methods



8. Set Your Shipping Preferences   (link)

Tools > Web Store > Admin Panel > Shipping

Restricted Shipping - allows you to restrict the available choices for shipping destinations. For example, if you are in Utah, and you will only ever ship to customers in Utah, you can enable Restricted Shipping, and then only define destinations based in Utah as outlined in step 10 below.

Weight Unit - sets Pound or Kilogram as the unit of weight measurement

Dimension Unit - sets Inch or Centimeter as the unit of dimension measurement

Restricted Shipping



9. Set Your Shipping Methods

Tools > Web Store > Admin Panel > Shipping > Methods

The Web Store uses a shipping calculator to calculate shipping charges based on the destination of the Web Order. Charges are applied the same way they are in LightSpeed, by creating a "shipping" Product that is used to calculate based on weight, volume, or item count. While they will be informed of the shipping charge upon checkout, the shopper will not see this Shipping Product until they are sent a copy of the LightSpeed Invoice.

Each shipping method must be linked to a specific Product set up in LightSpeed to charge shipping, using the LightSpeed Product Code field in each method's settings of the Admin panel. Most shipping methods allow for a price markup or a handling fee to be added to any shipping charges. 

UPS, FedEx, Australia Post, Canada Post, US Postal Service, IUPS, InterShipper - allows you to enable and configure each carrier and the account information that you have received from the carrier

Store Pickup - allows your customer to arrange to pick up their order in-store, and allows you to decide which instruction message is displayed when they choose this method

Flat Rate Shipping - sets a flat rate based on item quantity, order weight, or a flat rate for the order itself

Destination Shipping - allows you to set shipping charges based on the destination of the Web Order, calculated by item count, weight, or volume

Store Pickup



10. Set Your Shipping Destinations and Taxes

Tools > Web Store > Admin Panel > Shipping > Countries, Destinations

Defining destinations in the Web Store is important for two reasons; shipping charge calculations, and tax calculations.

Countries, States, and Regions

LightSpeed Web Store comes pre-populated with all the world's countries, accessible in the Countries tab of the Admin panel's Shipping section. The default setting is for all countries to appear in the pop-up menu that is displayed when a customer is registering their account. Any countries that you do not want to appear in this list can be omitted by clicking the "gear" icon and selecting "No" from the pop menu in the Available? column.

The States/Regions tab comes pre-populated with the states/provinces/regions of the US, Canada, the UK, France, Germany, and Australia. When any of these countries are chosen in the shopper's registration, its list of sub-regions will auto-populate. To add to these lists, click the + Add icon at the bottom of the window, choose the country from the pop-up menu, and provide the name and code of the sub-region you're defining. Click the "checkmark" icon to save your addition.

Destinations & Taxes

The Web Store allows you to assign the Tax Codes you've configured in LightSpeed to the destinations you define in the Web Store Admin panel. When shoppers choose a particular destination as their ship-to address, the Web Store will apply the appropriate Tax Code as it has been assigned here.

Using the Restricted Shipping feature accessible in the Shipping tab, you can limit your customers to choosing from a list of pre-defined shipping destinations that you define here. If Restricted Shipping is not enabled, the customer can enter any address as the ship-to when they place an order, but if this address does not match a configured destination, no Tax Code will be applied to the Web Order.

  1. In the Destinations tab of the Shipping section, click the + Add icon at the bottom left to add a destination to the list.
  2. Choose the country and province/state/region for the destination you're defining.
  3. Set the range of postal or zip codes for which this destination and its Tax Codes will apply. If none are set, the Web Store will apply the assigned Tax Code to all orders that are set to ship to this destination, regardless of zip/postal code.
  4. Name the Tax label for this tax setup (reference purposes only)
  5. Assign a Tax Code to the destination using the pop-up menu. These Tax Codes reflect the Tax Codes that were defined in LightSpeed as of the most recent store update.

In the case the you are NOT using any of the pre-configured shipping services (eg. UPS, FedEx, etc), you can do a manual calculation of the shipping charges using Base Charge, Free Allowance, and Rate Unit. The Base Charge allows you to enter the base amount that is applied to all web orders. Free Allowance allows you to enter a certain number of units (based on what you've configured in Shipping > Methods > Flat Rate Shipping) that are not used to calculate charges. Per Rate Unit is the dollar amount to use to charge per unit (weight, volume, order) after the Free Allowance.

Flat Rate Shipping

Shipping Destination and Taxes



11. Set Your Pages Preferences   (link)

Tools > Web Store > Admin Panel > Pages

All "pages" in your Web Store - New Products, Promotions, Top Products, About Us, Contact Us, Privacy Policy, Terms and Conditions - provide you an opportunity to promote or highlight specific Products that will be showcased in a "slider" that displays four Products at once and can be "advanced' for the next set of four, and so on. Each of these "pages" in your Web Store also provide you an opportunity to communicate with your shoppers, giving them background and contact information, as well as details particular to your business policies.

Page Key - the text that appears in the URL to identify this page

Page Title - the title that appears at the top of the Browser window

Text - the text that appears on this page

Slideshow Product Tag - Web Keywords that have been assigned to the Products you wish to showcase in this page's slider. Example: If you enter "shoe" as the Slideshow Product Tag, all Products with "shoe" as a Web Keyword will appear in this page's slider. Multiple Product Tags can be set.

Meta Keywords - words that internet search engines use to find this page

Meta Descriptions - the description that appears for the page when an internet search engine produces a list of results

Pages Preferences



12. Set Your Administration Preferences   (link)

Tools > Web Store > Admin Panel > System > Configuration

Database Backup Folder

In the System Configuration section, you must indicate the web host folder where you will back up your database.

Confirmation Email

In the Email section, enter the info to define the settings for the email confirmation that your customer receives once they have placed an order.

Order From - the email address that will appear in the "from" section of the confirmation email the customer receives

BCC Address - the email address that will receive a BCC copy of the order confirmation

Email Signature - the signature that appears at the bottom of every order confirmation email

SMTP Server Info - the server, server port, username, and password information for your SMTP email server

E. Define your Web Categories and Keywords   (link)

Tools > Web Store > Web Categories, Web Keywords

Web Categories 

Web Categories set a system of organization you will use to create a directory that your shoppers will use to drill down to find the Product they need. There are 3 levels to Web Categories - Primary, Secondary, and Tertiary. Each Primary category may have a number of Secondary categories, which, in turn, may have a number of Tertiary Categories.  For example, you may have a Primary category called “Shoes”, then within that a Secondary category called “Sneakers”, then within that a Tertiary category called “Nike”.  

To create a new Primary category, click the + icon under the Primary Category column, enter its name, and click Save. To create a Secondary category within that Primary category, click the Primary category once to select it, and click the + icon under the Secondary Category column. Name the Secondary category, and click Save. To create a Tertiary category within that Secondary category, click the Secondary category once to select it, and click the + icon under the Tertiary Category column. Name the Tertiary category, and click Save. These categories will now be accessible in the Web tab of the Product card.

The order of your categories can be changed by clicking and dragging them within your lists. It is in this order that they will appear on your Web Store.  

Web Keywords 

You are able to assign up to 3 Web Keywords to each Product sold on the Web Store to assist your shoppers in finding the Product they need using a Search. If your shopper searches on any term assigned to a Product as a keyword, the Product will appear in the list of results. For example, if you have “tshirt” assigned as one of a Product’s Web Store Keywords,  that Product will appear when the shopper searches for “tshirt”, even if “tshirt” isn’t in the Product’s description. However, ANY Product that has tshirt in the description will also appear in the same search, even if they do not have “tshirt” set as a keyword. 

To create a new Web Keyword, click the New button at the bottom of the Web Keywords window. Add the keyword in the pop-out drawer and click Save. This keyword will now be accessible in the Web tab of the Product card.

Web Keywords

Choose Your Products

LightSpeed Product Card > Web Tab   (link)

Having configured both LightSpeed and the Web Store Admin panel, you must select which Products you wish to sell on the Web Store, and assign them with Web Categories and Web Keywords, giving shoppers two ways to locate the Products on your Web Store.  

A special Web Price and Web Description can be set that will override the regular Selling Price and Product Description.  The weight and dimension fields allow you to enter values that are used in the shipping calculator of the Web Store. 

Each Product can have up to 5 images stored in the image drawer, and all 5 of these images will be displayed and accessible in the Product detail page of the Web Store. To add multiple images, click Photo in the Product card to open the image drawer, and select the square where you wish to store the image. Drag the image from your desktop or a website and drop it into the primary square in the image drawer. 

Size-color combination Products in LightSpeed are brought together under a common style using the Size-Color Matrix. Uploading Matrix and Child Products to the Web Store allows shoppers to choose their size-color combination using 2 pop-up menus that allow them to select their desired Product. 

Any items that are assigned to a Product as Related Products and are uploaded to the Web Store appear in an animated slider that showcases these Products in a polished, easy-to-access way. 

You can use Set Product Info to set in a batch which Products you wish to sell on your Web Store, and Set Selling Prices to set in a batch the Web Price for these Products. For more information, see the Product Rules article.

Choose Your Products

Update Web Store

Tools> Web Store > Documents   (link)

With the Products you wish to sell on the Web Store enabled and configured, you must upload them to your Web Store, along with any documents you wish to use to enable particular Web Store features. 

Quotes - enables the Quote to Cart feature, allowing you to email Quotes from LightSpeed to customers along with a link that will take them to a pre-populated Web Store cart. 

Orders - enables your shoppers to look up outstanding LightSpeed Orders online.

SROs - enables your shoppers to look up outstanding Service Repair orders online. 

Click Update Store to upload any new or modified Products, as well as any documents you have indicated in the Documents tab.  The first time you update your Web Store with Products and Documents, it will require a considerable amount of time to complete the upload, depending, of course, on the number of items being uploaded. However, the initial update of basic settings, as outlined in step 2c, will not take long.

ONCE YOU GO LIVE - Once you are live with your Web Store, but before you download and receive any Web Orders, go to Admin Panel > Appearance > Products, and enable “Cache Categories”.

Shoppers Buy Online

Having found your Web Store using a search engine, customers can browse or search Products, add them to the cart, and even check out as a guest. If they register for an account, or log into an existing account, they are able to access their purchase history, create Wish Lists, look up oustanding LightSpeed Orders or Service Repair Orders, or purchase through their customer account. 

The major features available on the Web Store are as follows:

Drag and Drop Purchasing - for quick, intuitive shopping

Product Availability 

Product Slider - for showcasing products with an innovative interface

Feature Products - for spotlighting specific products for higher sales

Professionally-designed Templates

Cross-Selling  - for suggested selling of related products

Quote-to-Cart  - allows the merchant to email a Quote link from LightSpeed that takes the shopper to a pre-populated cart of those Products

Wish List - for later purchase, or for a gift registry

Customer Log-In - for sales history, Wish Lists, Order Lookups

Real-Time Shipping and Tax Calculators

HTML Email Notification - for stylized emails after purchase

Search Engine Optimization - for high-priority search engine results

Order/SRO Lookups - for direct customer convenience

Security Control - for safe, worry-free online credit card purchasing

When shoppers check out, taxes will be calculated based on their shipping address as you have defined in the Destinations tab of the Web Store Admin panel. They choose a Shipping Method, including any of the compatible carriers that you have enabled in the Web Store Admin panel.  Specific shipping options, such as overnight or priority, are available in a separate pop-up menu for most carriers. Once a method is selected, a shipping charge is calculated and added to the Order. 

The next step is for the shopper to choose a Payment Method.  If the Customer is paying by credit card, and selects Authorize.net Simple Integration, PayPal, or WorldPay, they will be redirected to that gateways’ web site to process their payment, and will be returned to the checkout area of your Web Store once it’s processed. If a Customer is paying by credit card and chooses Authorize.net Complex Integration, eWay, or Beanstream, they can process their encrypted payment without being redirected. In all cases, the authorization number of the transaction will be attached to the Web Order and downloaded into LightSpeed. If the shopper is going to pay using alternate means, such as Phone Order, Purchase Order, Cheque, or Cash on Delivery, the Web Store can notify your shopper of instructions or allow them to record specific information such as PO number. 

Once the shopper has entered their payment information, they must also enter a verification code of random letters and numbers generated and shown in an image, simply to verify that they are human, as opposed to a spam bot or other piece of spyware. If the shopper is paying by any credit card gateway that requires them to be directed to another site for payment, they must enter this verification code prior to being redirected. 

The Web Store in action

Download Web Orders

In the Web Store Setup panel Tools > Web Store > Setup, you have the option to either manually download the Web Orders that your shoppers have placed, or set them to automatically download at scheduled intervals, as frequently as once every 10 minutes. If Download Schedule is set to “Manually”, no Web Orders will be downloaded into LightSpeed until you click the Download Orders button. Otherwise, LightSpeed will download Web Orders from the Web Store automatically. 

a. Install the Web Order Tracker.

To be notifed of new Web Orders, install the Web Orders (Requested) Tracker. When you download new Web Orders, they will appear here.

b. Download Web Orders

c. Convert each Web Order into an Invoice.

As per the standard workflow of LightSpeed, convert your Web Orders to Invoices using the Invoice button at the bottom of the Order. Confirm which Products you will be sending to the Customer, and make any necessary edits prior to saving the Invoice. Save the Invoice. 

If the Customer had processed an online credit card payment for their Web Order, the Apply Credit button on the Payment layout of the Invoice will be accessible. Click it to access the credit created by the online payment, and apply it to the Invoice. If you need to bring in Products from your Suppliers to fulfill a Web Order, follow the standard ordering procedure outlined in the Ordering and Purchasing PDF document on the Training page of www.xsilva.com. For more information regarding the application of credits, please see the Getting Started section

Trackers