Legacy Knowledge Base
Published Jul. 2, 2025

Special characters are used in friendly URLs

Written By

Rita Schaff

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

  • Special characters, e.g. åäö are shown in friendly URLs, instead of showing the ASCII version.
  • Example: page is titled new page åäö becomes
    /new-page-åäö instead of /new-page-aao

Environment

  • DXP 7.0+

Resolution

  • This is the currently intended behavior, made by LPS-65233, to support multilingual character usage (in Unicode) for friendly URLs, and there is no option to configure it. There is an open Feature Request you can track: LPS-78008.

  • f you need an immediate resolution, you should consider custom development to implement your own business logic regarding normalization/transliteration. If you need help regarding this, kindly ask your Liferay contact person for further information.

Additional Information

  • At the time of writing, there is a bug: LPS-121817 that is blocking this customization.

  • So your options are:

    • Wait for the bug to be resolved, or

    • Use the workaround:

      • Setting its custom implementation directly in FriendlyURLNormalizerUtil by using the method com.liferay.portal.kernel.util.FriendlyURLNormalizerUtil.setFriendlyURLNormalizer(FriendlyURLNormalizer)

      • Or Overriding the default implementation with an Ext plugin like explained in here: Extending Core Classes Using Spring with Ext Plugins.

Did this article resolve your issue ?

Legacy Knowledge Base