Managing Site URLs

Configuring Friendly URL Separators

Liferay DXP 2024.Q2+/Portal GA120+

You can customize URL separators to improve URL readability and enhance SEO.

For example, web content articles use the default w separator in URLs, such as http://your-site/w/new-article. However, you can personalize this separator to web-content instead, resulting in more descriptive URLs like http://your-site/web-content/new-article.

Additionally, you can customize separators for other elements including asset categories, blog entries, display page templates, file entries, knowledge base articles, object entry folders (Liferay DXP 2025.Q2+), and web content articles. In Liferay DXP 2025.Q4+, an object entry uses the friendly URL separator set on its object definition instead. Earlier releases list an Object Entry URL Separator in these settings.

Customizable URL separators.

To configure friendly URL separators,

  1. Open the Global Menu (Global Menu), navigate to Control Panel, and open Instance Settings.

  2. Select SEO under Platform and click Friendly URL on the left.

  3. Change the default values to set your friendly URL separators.

    Click Reset to Default Value (Reset to Default Value icon) to go back to the default value.

    Warning

    Each category must have a unique separator.

  4. Click Save.

Below, a web content article appears in a display page template. The URL separator for the web content article is altered from w to web-content. If you refresh the page with the old URL, a 404 utility page appears, as the page uses a new separator now. Once you change the separator to the new value, the display page template appears again.

Configuring a friendly URL separator.