Legacy Knowledge Base
Published Jul. 2, 2025

How to Import LAR files with circular references?

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

  • While using the export-import features of Liferay, we often encounter the error that certain files cannot be imported because references are missing.
  • Even after importing the allegedly missing reference, the error still appears. The different elements from different pages reference each other and thus form a "circular dependency" which prevents the import.
  • What can we do to prevent these errors?

Environment

  • DXP 7.3+

Resolution

  • The errors appear in order to show the circular dependencies so this behavior is expected.
  • Please try to remove the circular dependencies by creating items in the Global scope (the Global site) in Liferay.
  • There are some limitations when the Global scope cannot be used. In those cases, please perform the following steps:
    1. Go to Instance Settings or System Settings > Infrastructure > VIRTUAL INSTANCE SCOPE > Export/Import
      mceclip0.png
    2. Uncheck the following options:
      • Validate file entries
      • Validation of journal feed references
      • Validate layout references
      • Validate missing references
    3. Import the LAR file again
    4. Check the unchecked options again

Additional Information

Did this article resolve your issue ?

Legacy Knowledge Base