Set Up a Product List Page Search Layout

The look and feel of the Point of Sale search results screen (aka PLP) is controlled by app config settings and the Search Layout associated with the app config.

Set the App Config Search Layout

There are several settings in the app config that affect the search screen:

  1. Go to your app config and click EDIT.
  2. Go to UI | SEARCH LAYOUTS.

The layout available include:

  • Search Layout (V1) - The Search Layout contains various settings.
  • No Search Results Layout - This shows a custom layout when there are no search results.
  • Default Search Display Style - This shows search results as a list or as a grid (typically grid).
  • Search Layout Grid Type - This specifies the number of columns to be shown (one, two, or three).
    Note
    Note For store app customers, there is a limitation of 2-wide, XXL thumbnails in the user interface. This means that only 2x2 products with XXL thumbnails are visible on the screen at first glance with the PLP Search Layout.
  • Show Price Slider in Refine Screen - When enabled, the price filter is a slider as opposed to a dropdown list of price ranges.

Set the Search Layout Options

The Search Layout contains settings that control the behavior, look, and feel of the search screen. To edit the Search Layout that is associated with an app config:

  1. Go to your app config and click EDIT.
  2. Go to UI | SEARCH LAYOUTS.
  3. Click the pencil icon to the right of Search Layout (V1).

The settings available include:

Settings Description
Search Settings Settings in this section enable you to customize the overall appearance of the search screen
Variants and Wishlist Template Settings

Customize wishlists and product variants with the settings in this section.

Note
Note Note that the "Template" setting must be set to "Variants and Wishlist Template" to access these options.
Cell Settings Customize the cells, which are the parent containers of each search result. For instance, to remove the cell border, select "None" for "Cell Border Thickness."
Title Text Settings Control the appearance of the product title under the image using the settings in this section
Promotion Text Settings Manage the look and feel of promotion text. Please keep in mind that in Field Mappings, the source field mapped to "promotion_title" will be used for the promotion text.
Price Text Settings Adjust the appearance of the price text with the settings provided in this section
Banner Settings

Customize the banner's appearance with the settings available here. In Field Mappings, any source field mapped to a target field can be used as the Banner Product Field Name. This field can be either text or an image URL.

Note
Note To display the banner, ensure that the "Enable Banner" flag is turned on in two locations: the Search Layout and the App Config (App Config > Modules > Settings).
Ratings Settings Control the look and feel of product ratings with the settings in this section

Set the Template

The right side of the screen shows a preview of the template: A design layout showing template options and a product display.The templates available include:

  • Default template - The price is above title. The default template and a banner. The price appears first, then the banner ("WIDE WIDTHS AVAILABLE"), then the title.
  • Default template, text fields reversed - The title is above price. The default template, text fields reversed, and a promotion. The title appears first, then the price, then the promotion ("NOW XX% OFF").
  • Variants and wishlist template - This shows swatches and wishlist icon. The variants and wishlist template. Tapping the swatch causes the image to change so that the user can preview different colors. When the wishlist is enabled a heart icon appears in the bottom right of each search result cell.

Test Changes

After saving changes to the app config or Search Layout, the changes are visible after relaunching the app. To test changes without affecting production, use a test app config that is linked to a test Search Layout.

  1. Save app config or Search Layout.
  2. Relaunch the app.
  3. Do a product search.