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.
Migrating
Before you migrate to HCL Commerce Version 9.1, review this information to help plan and execute your migration.
... to HCL Commerce Version 9.1 solutions
The following section presents the high-level concepts and steps that you must understand and complete in order to upgrade from earlier WebSphere Commerce technologies to those introduced in HCL Commerce Version 9.1.
UI Migration from Aurora, Emerald, or Sapphire to the Ruby storefront
The transition from Aurora (JSP), Emerald, or Sapphire (React) to the Ruby (Next.js) storefront requires a fresh UI implementation rather than a traditional migration. This is due to fundamental differences in the underlying technology stack, architecture, and frontend framework.

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.
  - Planning to migrate WebSphere Commerce
    Most businesses treat investments in technology updates and migrations as overhead expenses. Even though you might need to upgrade or migrate to the latest HCL Commerce version to take advantage of the technological offering, providing a business justification to do so requires outlining the business benefits, strategy, and migration plan.
  - ... from IBM Websphere Commerce Version 7
    The following section presents the high-level steps that you must complete to migrate from IBM Websphere Commerce Version 7 to HCL Commerce Version 9.1. Select the IBM Websphere Commerce Version 7 Feature Pack that you are migrating from to begin your migration.
  - ... from IBM Websphere Commerce Version 8 to HCL Commerce Version 9.1
    The following section outlines the high-level steps that you must complete to migrate to HCL Commerce Version 9.1. Begin by migrating your development environment, which includes your development database, custom assets, storefront, and search application. With a successfully migrated development environment, you can migrate your production databases, and deploy your migrated assets to your HCL Commerce Version 9.1 production environments.
  - ... from HCL Commerce Version 9 to HCL Commerce Version 9.1
    The following section presents the high-level steps that you must complete to upgrade from an earlier version of HCL Commerce Version 9 to a newer version of HCL Commerce Version 9.1.
  - ... to HCL Commerce Version 9.1 solutions
    The following section presents the high-level concepts and steps that you must understand and complete in order to upgrade from earlier WebSphere Commerce technologies to those introduced in HCL Commerce Version 9.1.
    - Migrating from Solr to Elasticsearch
      The following table describes the Solr-based and Elasticsearch-based search solutions and their conceptual and technical paradigms. A guideline is also presented for considerations for migrating from the Solr-based search solution to the Elasticsearch-based solution.
    - UI Migration from Aurora, Emerald, or Sapphire to the Ruby storefront
      The transition from Aurora (JSP), Emerald, or Sapphire (React) to the Ruby (Next.js) storefront requires a fresh UI implementation rather than a traditional migration. This is due to fundamental differences in the underlying technology stack, architecture, and frontend framework.
- 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.
- 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.

UI Migration from Aurora, Emerald, or Sapphire to the Ruby storefront

The transition from Aurora (JSP), Emerald, or Sapphire (React) to the Ruby (Next.js) storefront requires a fresh UI implementation rather than a traditional migration. This is due to fundamental differences in the underlying technology stack, architecture, and frontend framework.

There is no direct migration path, as the codebase, rendering model, and extensibility approach in Ruby differ significantly from Aurora, Emerald, or Sapphire storefronts. Existing data, configurations, and customizations cannot be transferred directly. Customers must reimplement their UI configurations, custom features, and integrations to align with the architecture, APIs, and capabilities of the Next.js-based storefront.