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, go to Catalog > Products.

  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, click the calendar (). Then, choose the first date that you want the product to be featured.

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

    “Set Product As New” Date Range

  3. When complete, click 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, go to Content > Elements > Widgets.

  2. In the upper-right corner, click 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. Click 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, click 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. Click 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.

  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, click 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, go to Content > Elements > Pages.

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