Legacy Knowledge Base
Published Sep. 10, 2025

How to identify the filename for a System Settings configuration file

Written By

Brian Suh

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

  • This article documents how to determine the filename that should be used for a Systems Settings configuration file (.config) that can be inserted into $LIFERAY.HOME/osgi/configs.
  • Why? The creation of System Settings .config files permits you to transfer configurations between one Liferay DXP system to another in a consistent manner. Sometimes developers choose to distribute the default configuration for their applications via a configuration file.

Environment

  • Liferay DXP 7.0, 7.1, 7.2

Resolution

  • In order to identify the filename that should be used for a .config file from System Settings, the easiest route is to perform the following steps:
    1. Go to Control Panel > System Settings
    2. As default configuration sets will not be exported to a text file, modify the setting in question to ensure that the export functionality (in the next step) will pick up on the changes. For example, if I want to identify Forms portlet's configuration filename, I will temporarily make a change onto one of the configurations, then save it.
    3. Go back to System Settings, and click on the ⁝ in the far right corner, and click Export All Settings.
    4. A ZIP file will be generated, and enclosed within it will be all of the CONFIG files that are generated. If we're referring to the Forms portlet example, we can see that a file called com.liferay.dynamic.data.lists.form.web.configuration.DDLFormWebConfiguration.config is included. This file can be configured as desired and inserted into $LIFERAY.HOME/osgi/configs for further use.

Additional Information

  • Understanding System Configuration Files for Liferay DXP (Official Documentation)
Did this article resolve your issue ?

Legacy Knowledge Base