Legacy Knowledge Base
Published Sep. 10, 2025

Can I change a single configuration value with the help of a .config file?

Written By

Tímea Bihari

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

  • I would like to change just a single configuration value with the help of a .config file.
  • I would like to know if it is possible to enter this single value in my .config file or whether the file has to contain all configurations.

 

Environment

  • Liferay DXP 7.0+

 

Resolution

  • Yes, it is possible to enter just a single (or a few) configuration values in a.config file and those values will be applied as necessary.
  • Please consider the following scenario:
  1. Start a clean Liferay 7.2 environment
  2. Navigate to Control Panel > System Settings > Template Engines > FreeMarker Engine
  3. Scroll down to the bottom to see that the default value for Template Exception Handler is "rethrow"
  4. Add a .config file in osgi\configs named com.liferay.portal.template.freemarker.configuration.FreeMarkerEngineConfiguration.config and add this entry only: templateExceptionHandler="ignore"
  5. Restart the portal
  6. Navigate to Control Panel > System Settings > Template Engines > FreeMarker Engine

Result: The value for Template Exception Handler changed to "ignore". 

 

Additional Information

Did this article resolve your issue ?

Legacy Knowledge Base