Submit Feedback
Legacy Knowledge Base
Published Jul. 2, 2025

How to resolve "Unable to validate referenced file entry" UI errors preventing Web Content from being updated

Written By

Isaac Wilson

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

  • When trying to update a previously published web content article, clicking the Publish button results in an error message in the UI like the following:
    Error: Unable to validate referenced file entry because it cannot be found with the following parameters:
    {groupId=[33499], uuid=[fb3055e5-cl46-03b2-789b-fab7ac3a82d8], endPos=[17527]}

Environment

  • DXP 7.0
  • DXP 7.1
  • DXP 7.2

Resolution

  • To resolve the UI error and successfully publish the modified content, locate the incorrect link present within the web content asset and remove or correct the hyperlink/reference
  • This issue is encountered because the web content asset contains a broken link to a document  (either due to a typo within a hyperlink, a previous document library rollback, etc.). If no links were added while editing the article (or, a link is added but is verified to be correct), it is possible that the link was originally included within an earlier version of the asset while file entry verification was disabled (this can be tested by attempting to publish a new version of the asset without making any changes to the existing links).

Additional Information

  • The fix for LPS-104676 (implemented in 7.1 with dxp-17 and 7.2 with dxp-4) expanded the phrasing included within the UI error message to make it more user-friendly (to additionally include the specific link that is determined to be incorrect), for example: 
    Error: Unable to validate referenced document because it cannot be found with the following parameters:
    {groupId=[33499], uuid=[fb3055e5-cl46-03b2-789b-fab7ac3a82d8], endPos=[17527]} when analyzing link /documents/33499/1234567/Link-for-document-with-typo/fb3055e5-cl46-03b2-789b-fab7ac3a82d8
    If using 7.1 or 7.2, patching to those fix packs or above can expedite the process for locating the link leading to validation failures.

  • Alternately, this issue can be bypassed using a workaround: turning off validations for file entries, as described in this Help Center article. However, this will allow broken links to be published within newly created web content articles, so use this workaround with caution.

 

 

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?