Legacy Knowledge Base
Published Jun. 30, 2025

The Blueprints are not visible on the pages after upgrade process

Written By

Kartik Singh

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

  • Upgraded the Liferay from DXP 7.4 update 31 to the latest release (DXP 2024.Q2 is the latest one at the time of writing this article), the blueprint is not visible on the pages, which was configured in the previous update.
  • Steps to reproduce:
    1. Start DXP 7.4 update 31
    2. Navigate to Application Menu > Application > Search Experience > Blueprints > click on the '+' button, create a few blueprints, and save them.
    3. Navigate to Site Builder > Pages > click on the '+' button and create the widgets pages.
    4. After the Widget pages are created, configure the 'Blueprints Option' widget and add the blueprints to all the widget pages.
    5. After performing the above steps, delete one of the blueprints.
    6. Upgrade this update to the latest one (This testing was completed with Update 31 to DXP 2023.Q4.4).
    7. Start the Liferay server and perform the reindexing.
    8. Note that all 'Widget Pages' are visible with the "Blueprints Options" widget but, the blueprints are not visible in the 'Blueprints Option' that has been added in the previous DXP update 31.

Observed Behavior: The Blueprints are not visible on the pages after the upgrade.
Expected Behavior: The Blueprints should be visible on the pages after the upgrade.

Environment

  • Liferay DXP 2023.Q4.4
  • Liferay DXP 2024.Q2.0

Resolution

  • Once the Liferay upgrade was completed, the ‘name’ and ‘smallValue' columns of the ‘PortletPreferenceValue’ table, the data changed from ‘sxpBlueprintId’ to ‘sxpBlueprintExternalReferenceCode’ according to the 'SXPBlueprint Options portlet upgrade process’.
  • In this case, the values didn't change, it showed the same ‘sxpBlueprintId' instead of showing ‘sxpBlueprintExternalReferenceCode’.
  • The observed behavior is a known bug that has been addressed by: LPD-30441

Additional Information

Did this article resolve your issue ?

Legacy Knowledge Base