Home
Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels. Business users can also use AI enabled content management capabilities.
Samples
Topics in the Samples category highlight the various samples that are provided with HCL Commerce.
Store samples
HCL Commerce includes sample storefront designs that illustrate the use of the remote store model.
Aurora starter store
The Aurora starter store showcases the latest in storefront features, and models best practices in store development, demonstrating a wide scope of retail scenarios. Simplify your responsive B2C or B2B web store implementation and reduce your time-to-market by using the Aurora starter store as your development base.
Site flows and interactions
The site flows provide a screen capture and a detailed description for each store page. Store developers can use the site flows as a high-level guideline for each page to identify starting points when store pages are changed.
Additional flows
The Additional flows describe the supplementary pages that are required to maintain your online store.
Store Locator page
The Store Locator page is where customers can go to locate a physical store. Customers can select a geographic area and view the list of stores that are located in the area.

Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels. Business users can also use AI enabled content management capabilities.
- Getting started
  HCL Commerce has different advantages for business users, administrators and developers. HCL Commerce targets each of these roles with a tailored set of offerings so that each of your users can get maximum benefit.
- Installing and deploying
  Learn how to install and deploy HCL Commerce development environments and HCL Commerce production environments.
- Migrating
  Before you migrate to HCL Commerce Version 9.1, review this information to help plan and execute your migration.
- Operating
  Topics in the Operating category highlight tasks that are typically performed by business users, customer support representatives, to complete their day-to-day tasks in the operation of the HCL Commerce site.
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using HCL Commerce in combination with other products.
- Administering
  Topics in the Administering category highlight tasks that are typically performed by the Site Administrator, to support daily operations of the HCL Commerce site.
- Customizing
  The topics in the Customizing section describe tasks performed by an application developer to customize HCL Commerce.
- Tutorials
  HCL Commerce provides many tutorials to help you customize and understand your HCL Commerce instance and stores.
- Samples
  Topics in the Samples category highlight the various samples that are provided with HCL Commerce.
  - Store samples
    HCL Commerce includes sample storefront designs that illustrate the use of the remote store model.
    - Aurora starter store
      The Aurora starter store showcases the latest in storefront features, and models best practices in store development, demonstrating a wide scope of retail scenarios. Simplify your responsive B2C or B2B web store implementation and reduce your time-to-market by using the Aurora starter store as your development base.
      - Aurora starter store features
        The Aurora starter store contains features at the site, category, product, and search-levels. It also contains B2B-optimized functionality and follows the IBM accessibility guidelines to implement accessibility features.
      - Aurora starter store functions
        For the Aurora starter store, you can select certain functions to include in your store and disable the ones that you do not need. Use the Store Management tool in Management Center to control which functions are enabled for your store.
      - Site flows and interactions
        The site flows provide a screen capture and a detailed description for each store page. Store developers can use the site flows as a high-level guideline for each page to identify starting points when store pages are changed.
        Site flows overview
        Site flows provide a comprehensive layout of each store page and explain how pages relate to one another. Use the site flow topics to understand the standard and optional functions of each page, and to learn how to get data into the page.
        Header and footer
        The Aurora starter store provides multiple layouts for the header and footer.
        Catalog browsing flows
        Catalog browsing flows describe pages that your customers use to browse and search categories and products on your storefront.
        Content pages
        The term content page refers to a store page that is managed in the Commerce Composer tool but that is not a catalog page. An example is the About Dress Designer page.
        Checkout flows
        Checkout flows describe pages that your customers use to complete the checkout process.
        My Account flows
        The My Account flows describe pages your customers use to register with the online store and maintain their account with the store. The My Account pages include the account summary, personal information, address book, personal wish lists, coupons, orders, order details, and browsing history. Certain pages are optional and are available to customers only if your store chooses those functions.
        Additional flows
        The Additional flows describe the supplementary pages that are required to maintain your online store.
        Site map page
        The Aurora starter store provides multiple layouts for the site map page.
        Help page
        The Help page is where customers can view a list of frequently asked questions about your store.
        Contact Us page
        The Contact Us page is where customers can view the contact information for your store.
        Return Policy page
        The Return Policy page is where customers can learn about the return policy for your store.
        Privacy Policy page
        The Privacy Policy page is where customers can view the privacy policy statement for your store.
        Just-in-Time Privacy Policy
        When enabled, the Just-in-Time Privacy Policy page is displayed as a pop-up window when a shopper first visits your store. Shoppers must review and accept the store privacy policy that is included on the page before they can proceed to browse and shop within the store.
        The About Us page
        The About Us page is where customers can read detailed information about your store, your company history, and your mission statement.
        Corporate Contact Us page
        The Corporate Contact Us page is where customers can view information about the head office, or corporate store.
        Store Locator page
        The Store Locator page is where customers can go to locate a physical store. Customers can select a geographic area and view the list of stores that are located in the area.
        Error Pages
        Customers view error pages on the storefront for various reasons. The error pages that are displayed here are examples with default error text. During site setup, you can change both the text and the appearance of these messages to suit your business.
        Store emails
        In certain circumstances, your store sends email messages to customers. You can customize three of these email messages through the Management Center Marketing tool. In each email message, the images and text are displayed in e-Marketing Spots. You can change the content that is displayed in the e-Marketing Spots in the same way that you manage e-Marketing Spots on your store pages.
        Organization and buyer administration flows (B2B)
        In the B2B business model, each company that purchases from your store must have one or more registered users who are assigned the Buyer Administrator role. Buyer Administrators administer the company's organizations, and they manage the company's buyers, including assigning roles and approving new buyers who register. The Aurora starter store provides a series of self-serve pages for Buyer Administrators to do their work directly in the storefront, rather than using the Organization Administration Console.
        Order approval flows
        During organization setup, order approvals and contracts can be configured to set the criteria that determines which orders require approval. When order approvals are enabled, a Buyer Approver or Buyer Administrator must approve orders that exceed the order total limit that is specified in the contract before orders are submitted for processing. The Aurora starter store contains pages in which Buyer Approvers and Buyer Administrators can view and manage order approvals.
        Buy-on-behalf-of flows
        The buy-on-behalf-of feature allows a Buyer Administrator to shop on behalf of a buyer in the same organization. After signing in to buy on behalf of a specific buyer, the Buyer Administrator sees the store exactly the way that buyer would see the store. The Buyer Administrator can then lock an order and proceed to create, modify, or view the buyer's information such as saved orders, order history, and requisition lists. When an order is locked, a symbol appears beside the order number.
    - Extended sites starter store
      Use an extended sites starter store to get started on setting up an extended sites solution that will allow your selling organization to provide unique storefronts for different enterprise customers or showcase a number of branded storefronts.
    - Reference React stores
      The Store SDK includes a reference B2C (Emerald) store application and a reference B2B (Sapphire) store application. Use these Reference Store applications to develop and deploy your own React Store applications.
    - Next.js starter store
      The Next.js store offers customizable features for storefronts using the Next.js framework. It uses the same data template as the ReactJS stores and supports business-to-consumer (B2C) and business-to-business (B2B) use cases. The store includes pages for browsing, shopping, checkout, and account management, and uses Elasticsearch for search functions.
  - Access control policy samples
    The following access control policy samples show you how some basic access control policies can be used in the development environment, so that you can quickly test new resources. They are not designed to be used as-is on an HCL Commerce production environment, as they do not provide adequate resource protection.
- Compliance
  The following section describes how you can leverage HCL Commerce features and functionality to help your site be compliant with different privacy and security standards.
- Securing
  These topics describe the security features of HCL Commerce and how to configure these features.
- Performance
  Topics in the Performance section describe the means by which to plan, implement, test, and re-visit the optimization of HCL Commerce site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with HCL Commerce, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the HCL Commerce reference documentation.

Store Locator page

The Store Locator page is where customers can go to locate a physical store. Customers can select a geographic area and view the list of stores that are located in the area.

Elements of the Store Locator page

JSP files

StoreLocatorDisplay.jsp represents the entire page.
StoreLocator.jsp represents the actual store locator page area.
SelectedStoreList.jsp represents the area where a selected stores are found.
ProvinceSelectionDisplay.jsp represents the state/province drop-down area.
CitySelectionDisplay.jsp represents the city drop-down area.
StoreLocatorResults.jsp represents the result of the store locator search.

Error handling

When entering invalid or missing store location information to find, the store returns a 400 error (bad request) by default.