New Products List

The list of new products is an example of dynamic content, and consists of live data that is pulled from your product catalog. By default, the “New Products” list includes the first eight of the most recently added products. However, it can also be configured to include only products within a specified date range.

New Products List on Home Page

Step 1: Set the Date Range for Each Product

To make a product appear in the list by date range, the “New From” dates must be entered in the product. The product then appears in the New Products list during the date range specified.

  1. On the Admin sidebar, tap Products. Then under Inventory, choose Catalog.

  2. Find each product that you want to feature, and open in edit mode. Then, do the following:

    • In the Set Product as New From field, tap the calendar (). Then, choose the first date that you want the product to be featured.

    • In the To field, tap the calendar (). Then, choose the last date that you want the product to be featured.

    “Set Product As New “ Date Range

  3. When complete, tap Save.

  4. When you are prompted to reindex and refresh the page cache, click the links at the top of the workspace, and follow the instructions.

    The list of products now appears on the Home Page for the specified date range.

Step 2: Create the Widget

The code that determines the content of the New Products list and its placement in your store is generated by the Widget tool.

  1. On the Admin sidebar, tap Content. Then under Elements, choose Widgets.

  2. In the upper-right corner, tap Add Widget.

  3. In the Settings section, do the following:

    • Set Type to “Catalog New Products List”.

    • Choose the Design Theme that is used by the store.

  4. Tap Continue.

    Widget Type

  5. In the Storefront Properties section, complete the following fields:

    Widget Title Enter a descriptive title for your widget. This title is visible only from the Admin.
    Assign to Store Views Select the store views where the widget will be visible. You can select a specific store view, or “All Store Views”.
    Sort Order (Optional) Enter a number to determine the order this items appears with others in the same part of the page. (0 = first, 1 = second, 3= third, and so on.)

    Storefront Properties

Step 3: Choose the Location

  1. In the Layout Updates section, tap Add Layout Update. Then, do the following:

    • Set Display On to “Specified Page”.

    • Set Page to “CMS Home Page”.

    • Set Block Reference to “Main Content Area”.

    • Set Template to one of the following:

      • New Product List Template
      • New Products Grid Template

      Layout Updates

  2. Tap Save and Continue Edit.

    For now, you can ignore the message to refresh the cache.

Step 4: Configure the List

  1. In the panel on the left, choose Widget Options. Then, do the following:

  2. Set Display Products to one of the following:

    All Products Lists products in sequence, starting with those most recently added.
    New Products Lists only the products which are identified as “New”. A product is considered to be new during the date range that is specified in the “Set Product As New From/To” fields. The list will be empty if the date range expires without any new products defined.
  3. Complete the remaining information as follows:

    • To provide navigation control for lists with multiple pages, set Display Page Control to “Yes”. Then, in the Number of Products per Page field, enter the number of products you want to appear on each page.

    • Set Number of Products to Display to the number of new products that you want to include in the list. The default setting is 10.

    • In the Cache Lifetime (Seconds) field, choose how often you want to refresh the list of new products. By default, the cache is set to 86400 seconds, or 24 hours.

    Widget Options

  4. When complete, tap Save.

  5. When prompted to refresh the cache, click the link in the message at the top of the workspace, and follow the instructions.

Step 5: Preview Your Work

  1. On the Admin sidebar, tap Content. Then under Elements, choose Pages.

  2. Find the page in the grid where the New Products list is to appear. Then, in the Action column, click the Preview link.