Submit Feedback
Legacy Knowledge Base
Published Jul. 2, 2025

Issues with downloading a zip file containing special characters

Written By

Solyom Nagy-Györkös

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 we want to download a "bulk" file (.zip file) from Liferay's Documents and Media and the included content contains any special characters (e.g.: ö, ü, ä etc.), there are different issues depending on the OS we use:
    • Windows: An extra folder is added with a corrupted name
    • Linux/MacOS: Extracting the zip file fails with errors

Environment

  • DXP 7.3 below Update 8
  • DXP 7.4 below Update 32

Resolution

  • This is a known issue, resolved by LPS-148397. You can either wait for it to be released in official Updates (Update 8 for DXP 7.3 and Update 32 for DXP 7.4), or request a hotfix from Liferay Support.
  • In case of JDK 9 or a newer version: Even if you have the fix, the download won't initiate and a new blank page opens, but nothing happens.
    • To resolve that, add the following line to the configuration file, if you are using a bundle of DXP, or you can add it to your custom startup script after setting CATALINA_OPTS on your system:
       
      JDK_JAVA_OPTIONS="$JDK_JAVA_OPTIONS --add-opens=jdk.zipfs/jdk.nio.zipfs=ALL-UNNAMED"
      • After adding this to your setenv.sh, please restart the portal and check the use case again. 
Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?