Broadleaf Microservices
  • v1.0.0-latest-prod

Release Notes for 1.8.12-GA


  • JDK 11 is required for Broadleaf release trains 1.7.0-GA, and beyond.

  • JDK 17 is supported for Broadleaf release trains 1.8.1-GA, and beyond.

New Features & Notable Changes

  • To improve performance from admin views, the following changes were made to product export metadata views

    • The default polling interval for both active and completed product exports was updated to 5 seconds.

    • Properties were added to disable polling on active or completed product exports

  • Changed BusinessTypeField and JpaBusinessTypeField defaultValue attributes class to Object from String

  • Added support for marking Product Business Types as templates. This allows for the creation of business types that are to be used solely as templates for other business types. This is useful for creating a business type that is used as a parent for a new product type, but should not be used directly by a product.

  • Added support to mark entire groups of fields as hidden when configuring a product type. This is useful for hiding fields that are not relevant to a particular product type.

  • Support import and export of business types

    • Add the businessType field to the product export specification.

    • Add method preFetchBusinessTypes to validate that the businessType specified in import records exist.

  • Avoid potential error when enabling the legacy Product maintenance view due to customizations

    • An error can occur when adding back fulfillment related fields if the FULFILLMENT form has been added to a new Product Type or if the FULFILLMENT_TYPE group has been otherwise removed from that Form. A safeguard was put in place to prevent this error

  • Removed final scope from breadcrumb details contributor classes methods

  • Added itemChoiceAttributes field to JpaOptionTemplate

Bug Fixes

  • Fixed CategoryDetails not including products when the category is rule-based

  • Fixed ProductDetails not including all products when the Category used by a Category-based ItemChoice is uses rules and explicit products.

  • Fixed issue where variants are not archived when product is archived

    • Added validation to prevent product archival when sandbox relationship entities exist

    • Added listener to archive product relationship entities when product is archived, specifically:

      • ProductAsset

      • Variant

      • ProductTag

      • CategoryProduct

      • PromotionalProduct

      • Translation

  • Fixed incorrect Category Product result set sort order when viewing in Admin in cases where a very large number of products were explicit members of the category.

  • Fixed the lookup used when reordering Category Products in reference to each other (rather than using drag-and-drop) not filtering out unsorted Category Products.

  • Fixed productFilterRulesExtractor bean not being conditional on missing bean with the same name since there can be multiple other CatalogFilterRulesMapping in the system, making the bean type incorrect for the condition.

  • Fixed issue where a variant’s name was not displayed in the admin for bundled items

  • Fixed issue where indexing of a bundle type product would fail if it contained multiple variants

  • Fixed issue with creating item choice options when using multiple variations caused by incorrect metadata

Upgrade Guide

Configuration Properties

Added Properties

  • broadleaf.catalog.metadata.product-active-export-polling-enabled

    • Description: Whether or not to enable polling for updates when viewing active product exports

    • Default Value: true

  • broadleaf.catalog.metadata.product-inactive-export-polling-enabled

    • Description: Whether or not to enable polling for updates when viewing completed product exports

    • Default Value: true


    • Description: Time-to-live for reading products that belong to a rule-based Category for category-details requests

    • Default Value: 5 minutes