Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

LayoutFriendlyURLsException Thrown on Upgrade to 7.3

Written By

Madeleine Clay

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

  • Upon upgrading to 7.3, a LayoutFriendlyURLsException was thrown on startup, even though no failures were present in the upgrade logs:
WARN  [Portal Dependency Manager Component Executor--1][PortalInstanceLifecycleListenerManagerImpl:146] Unable to register portal instance {mvccVersion=4, companyId=20101, accountId=20101, webId=liferay.com, mx=website.org, homeURL=, logoId=0, system=false, maxUsers=0, active=true}
com.liferay.portal.kernel.exception.LayoutFriendlyURLsException: com.liferay.portal.kernel.exception.LayoutFriendlyURLException
[...]
Caused by: com.liferay.portal.kernel.exception.LayoutFriendlyURLException
  • I'm not sure why there is no home URL value in this error (homeURL=), because a layout with the name home and a friendlyURL of /home already exist 

Environment

  • 7.3

Resolution

For cases where the root cause matches what is described below in the additional information section, there are two possible resolutions:

  1. Change the default layout name in the property default.guest.public.layout.name=home to another guest layout name.
  2. Make at least 1 layout on the guest site not hidden from the navigation menu using the following steps:
    1. Go to the Guest Site > Site Builder > Pages, Select the 3 dots next to a page and go to Configure
    2. Uncheck "Hidden from Navigation Menu Widget"

 

Additional Information

  • This issue was caused by a guest site without any layouts in the navigation menu, which triggered Liferay to try to add a new layout using the following property: default.guest.public.layout.name=home.
  • Because a layout with the name home and a friendlyURL of /home already existed, Liferay was unable to create a new layout with the name "home" for the guest site, and the LayoutFriendlyURLsException was thrown.

 

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?