Follow the instructions below to configure products using the new Cloud UI Product Detail Page.
IMPORTANT: While Cloud UI is supported for most product detail pages, some features and configuration options are not yet supported in Cloud UI. These configurations will continue to work as usual if loaded on the Legacy pages. See section 1 below for a detailed list of incompatible configurations.
Prerequisite Tasks
This section describes all requirements that must be completed before you can begin setting up this feature. Once these tasks are complete continue to the next section.
Infrastructure Tasks REQUIRED
Ensure that your environment has been upgraded to the latest infrastructure recommendations and Cloud UI is enabled. If you have any questions on the status of your environment, reach out to your Aspenware representative
Upgrade to Aspenware Commerce 3.3 or later.
Work with your Aspenware Service Agent (support@aspenware.com) on using Theme Designer to theme Cloud UI pages. See the Cloud UI Theming Details to learn more about what is customizable for the Cloud UI PDP.
Marketing Site / Email Update Tasks
IMPORTANT: The URL path of the calendar page and all transitioned PDP pages will be updated with this release from http://shop.store.com/s/category_path/c/product_path/ to https://shop.store.com/l/category_path/c/product_path/. The domain name will not change.
Any deep links from the marketing site must be changed to the /l/ path to take full advantage of the Pricing Calendar on the separate UI in this release, though this is not a hard requirement for Cloud UI 1.0. Deep links with the /s/ path will still work until the full migration is complete, though they won’t access the refreshed designs on the Cloud UI.
For the best user experience, it is advised that product detail page deep links on the marketing site and from emails be updated to use the new url path, which uses an /l/ between the host domain and category slug rather than an /s/. See the “important” box above. However, if a deep link to a PDP is not updated, or a link is updated to use the Cloud UI url and that product page should continue to render in Legacy, the shop will handle re-directing the user to the correct experience (Legacy or Cloud UI) automatically so that customers have a consistent experience with a given product, regardless of their origination route. This auto-redirection can be enabled and disabled using the setting ‘awcloud.redirectenabled.’
Commerce Tasks
If the product is configured to show the pricing calendar as the landing page, ensure the Cloud UI Full-Page Pricing Calendar is set in advance.
Configure Product Shell and Product Attributes as usual, but consider the following differences for the Cloud UI PDP.
[Dynamic] and [Conditional] are no longer needed as the Dynamic box is not used for the Cloud UI PDP and conditional logic will be driven off the Conditional Attribute setup described in Section 5 of the Product Attributes Configuration Guide.
Cloud UI offers better coach messaging if an attribute is required but not preselected. Defaults no longer need to be defined unless the product uses the pricing calendar.
Upgrade your Experience is a configurable Language String (see below)
Attribute descriptions are configured differently from what is documented in section 6 of the Product Attributes Configuration Guide. Follow the instructions below for Attribute descriptions.
Meta title text and price from related product’s configuration pulls through on related product cards.
Flag products that are not compatible with Cloud UI so that they continue to render in the Legacy UI. See section 1 below for flagging instructions and a complete list of incompatible product types.
Update the following settings in Aspenware Commerce Admin.
Click the square icon to expand the table ->
Setting | Details |
|---|---|
calendarsettings.useposinventory | Feature: Cloud UI Pricing Calendar Acceptable Values: Boolean - True/False Function: If TRUE, the color shading of the calendar is based on inventory. This is required for the Cloud UI Calendar if calendarsettings.enabledadvancedcalendar is set to true. |
calendarsettings.lowinventorybackgroundcolor | Feature: Cloud UI Pricing Calendar Acceptable Values: HEX Color, Recommended #F6D241 (yellow) Function: Color used to shade calendar on low inventory dates. |
calendarsettings.soldoutstatustext | Feature: Cloud UI Pricing Calendar Acceptable Values: Text, EX: UNAVAILABLE Function: Legend text for sold out dates |
awcloud.redirectenabled | Feature: Cloud UI PDP Acceptable Values: True False Function: This setting ensures that if a deep link from the marketing site is not properly set, the user will be routed to the correct PDP. Routing will direct to Cloud UI PDP or Legacy PDP, based on what is set at the product level. |
Detailed Setup Guide
Flag products that are incompatible with the Cloud UI PDP to continue to use Legacy UI PDP
Define Attribute Title(s) and Description(s) (Optional but Highly Recommended)
Configure data to enhance the item summary and cart notice (Optional but Highly Recommended)
Customize Language Strings as Desired (Optional but Highly Recommended)
1. Flag products that are incompatible with the Cloud UI PDP to continue to use Legacy UI PDP
Most products are Cloud UI compatible, but there are some exceptions. If a product has any of the following features/configurations enabled on the PDP it should NOT load on the Cloud UI and should be flagged to continue to display Legacy PDP. These products will continue to work if they retain their Legacy configuration and are flagged as noted below in the Setup Guide.
Radio button date products (section 2 of this guide) (Cloud UI compatibility coming soon!)
Time-based activity products (Cloud UI compatibility coming soon!)
Assigned to attribute with Assignment on the PDP (Cloud UI compatibility coming soon!)
Fenced products that can only be accessed using a valid voucher (Cloud UI compatibility coming soon!)
Fast Flow (Cloud UI compatibility coming soon!)
Payment Plan products (Cloud UI compatibility coming soon!)
Affirm enabled products (Cloud UI compatibility coming soon!)
Reservation products (Cloud UI compatibility coming soon!)
IKON Friends and Family ticket (Cloud UI compatibility coming soon!)
For these listed exception products, there is a new product-level setting that enables some products to continue to load for users in the Legacy UI, and for the majority of products to load in the new Cloud UI. Respecting this routing will work whether a PDP is accessed via the category page, related product link, or cross-sell link. To flag a product so that it continues to load in the Legacy UI:
Find the product from Catalog > Products >Edit
Scroll to the Aspenware Commerce section of the edit page
Locate the new product-level setting called Use Legacy Product Page.
Check the box
Click SAVE ALL SETTINGS
NOTE: Our goal is to make all Product Detail Pages (PDPs) compatible with the Cloud UI, except for Arrive Parking and Retail in the near term. Watch release notes or revisit the Incompatible Products List (detailed in section 1 below) periodically to check if the 'Use legacy' flag can be removed as new releases become available.
NOTE: This setting should ONLY be turned on if a product is incompatible with Cloud UI.
2. Define Attribute Title and Description (Optional but Highly Recommended)
In the Cloud UI PDP, Cloud customers can customize the titles and descriptions of product attributes. These titles and descriptions will appear above the corresponding attributes on the Product Detail Page (PDP).
To maintain a consistent design, the Cloud UI uses a predefined styling for attribute titles and descriptions. As a result, you won't have access to a rich text HTML editor for these fields. However, you can still include basic <a> links by using the plain text field if you want to link to external content from your attribute descriptions.
NOTE: It is recommended that you edit all attributes used on Cloud UI PDPs to ensure an optimal user experience.
To edit product attribute titles and descriptions:
Go to Catalog > Attributes > Product Attributes
Scroll to the desired attributes and select Edit
Edit the attribute as indicated below
Click Save
Attribute titles and descriptions can also be displayed for add-on product selections, to better explain the add-on, as in the example below.
3. Configure Data to Enhance Item Summary and Cart Notice (Optional but Highly Recommended)
There are several options for enhanced product configuration on the Cloud UI PDP that will offer information to the guest before they add to cart. The following graphic illustrates the possibilities and instructions for configuring each element are outlined below.
Define Variant Names to Display in the Item summary and Cart notice
If a product has attribute combinations defined, admins can define a name for each variant (product attribute combination). This name will be used in the item summary shown to customers before adding to cart on the PDP to describe the selected variant. It will also be passed into Google Analytics 4 as the variant name. If no product attributes are used, the product name will display in the item summary and be passed to Google Analytics 4 as the variant name.
For a better user experience and effective usage in Google Analytics 4 (GA4) reporting, it's advisable to review and edit all variants used on Cloud UI Product Detail Pages (PDPs). When doing so, aim for clear and concise variant names, keeping in mind that these names are visible to guests.
Variant names are also shown for add-on product selections to provide a more descriptive explanation of the add-on, similar to the example mentioned earlier. These variant names for add-ons will be set up and configured within the add-on product itself.
To edit product variant names:
Go to Catalog > Products
Edit the desired product.
Expand the Additional Product Settings section. Within this section, if attribute combinations are defined, each attribute combination will be populated in the table and can be edited.
Define Max Prices for Variants to Display in the Item summary and Cart notice
Note: If a product is dynamically priced, you won’t see max price in the Additional Product Settings table since max price for dynamically priced products should be configured using base price setup explained in the dynamic pricing guide.
If a non-dynamically priced product has attribute combinations specified, admins can set a maximum price for each variant (product attribute combination). For dynamically priced products, the maximum price should be defined using the Base Price feature in dynamic pricing. For products that don’t have attribute combinations, the maximum price should be defined using the “Old price” field in the product shell guide.
If a maximum price is defined, it will be used to highlight the cost savings when customers view the product summary before adding it to their cart on the Product Detail Page (PDP). This max price information will also be displayed for add-on products, showing the savings associated with purchasing online or in conjunction with another product in the add-on product experience.
It is recommended to edit all variants used on Cloud UI PDPs if the online price is cheaper than the maximum price to ensure an optimal user experience.
Max price can also be displayed for add-on product selections, to better explain the add-on, as in the example above. The max price for add-ons will be configured in the add-on product itself.
To edit product variant names:
Go to Catalog > Products
Edit the desired product.
Expand the Additional Product Settings section. Within this section, if attribute combinations are defined, each attribute combination will be populated in the table and can be edited.
If you want to configure the max price but not show it to the guest, you can hide savings information on the product or add on product itself within the Aspenware Commerce settings section. To hide savings information from displaying to guests uncheck “Show Max Price” and select Save All Settings. Show Max Price is true by default for all products.
4. Customize Language Strings as Desired (Optional but Highly Recommended)
Follow the instructions to edit the following language strings in Aspenware Admin.
Click the square icon to expand the table ->
Resource Name | Default/Function | Feature | Example |
|---|---|---|---|
shoppingcart.addtocart | Default: ADD TO CART | Cloud UI PDP |  |
products.relatedproducts | Default: Related Products | Cloud UI PDP - Related Products |  |
productattributes.selectoption | Default: Select Option Function: If an option a product page (on the pricing calendar or the pdp) is not set, used to coach users that an option is not set but either required or optional (see below) | Cloud UI PDP and Pricing Calendar |   |
optional | Default: Optional (parentheses are added by code, so don’t add parentheses) Function: Used in attribute selection coach messaging to indicate an option is optional, not required to enable add to cart | Cloud UI PDP |  |
required | Default: Required (parentheses are added by code, so don’t add parentheses) Function: Used in attribute selection coach messaging to indicate an option is required, a selection is required to enable add to cart | Cloud UI PDP and Pricing Calendar | |
aspenware.commerce.cart.itemsummary | Default: Item Summary Function: Title of Item Summary Box on PDP | Cloud UI PDP - Item Summary |  |
aspenware.commerce.cart.total | Default: Total Function: Label for the total of everything you are about to add to cart | Cloud UI PDP - Item Summary |  |
aspenware.commerce.cart.yousaved | Default: You save Function: Label to summarize online savings compared to window rate for product being added plus all add ons prior to adding to cart and in cart notice. | Cloud UI PDP - Item Summary |  |
aspenware.commerce.cart.startdate | Default: Start date Function: Label for selected date if product is dated | Cloud UI PDP - Item Summary |  |
aspenware.commerce.cart.onlinesavings | Default: Save {}% off list price. (where percentage is dynamically populated). Function: Label to summarize online savings compared to window rate for item being added (may also be used in cart notice once implemented) | Cloud UI PDP - Item Summary |   |
product.productattributes.addons.label | Default: Upgrade your experience Function: Title to separate the add on option selections from core product selections | Cloud UI PDP - Add ons |  |
publicui.cartnotice.itemadded | Default: Item added Function: Cart notice title | Cloud UI PDP - Cart notice |  |
publicui.cartnotice.applycoupons | Default: Apply coupons in the <a href=\"{cartUrl}\">cart</a> Function: Description to link to the cart so that users know to apply coupons in the cart | Cloud UI PDP - Cart notice |  |
publicui.cartnotice.checkout | Default: Checkout Function: Direct link to checkout if user is logged in. Will log user in then route to checkout if signed out. | Cloud UI PDP - Cart notice |  |
publicui.cartnotice.viewcart | Default: View Cart Function: Direct link to full cart page. | Cloud UI PDP - Cart notice | |
publicui.cartnotice.itemsubtotal | Default: Per Item Subotal Function: Price per item of what was just added to cart before discounts have been subtracted from the item price. | Cloud UI PDP - Cart notice |  |
publicui.cartnotice.itemstotal | Default: Per Item Total Function: Price per item of what was just added to cart after discounts have been subtracted from the item price. | Cloud UI PDP - Cart notice |  |
publicui.cartnotice.carttotal | Default: Cart Total Function: Displays the subtotal (before tax) of the entire user’s cart. | Cloud UI PDP - Cart notice |  |
publicui.cartnotice.itemupdated | Default: Item Changed Function: Title of cart notice if PDP is in edit mode and customer is changing something about an already added cart item. | Cloud UI PDP - Cart notice when product in edit mode |  |