Korean Characters display as square characters in Jira Chart macro

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary


This issue is specific to Linux environments where Korean fonts are not installed by default.

(info) Jira Chart is created in Jira and passed to Confluence. If the Jira Server does not have Korean font, the Korean characters in the Jira Chart macro display as garbled text in the Confluence like the following:

Environment

Usually happens in Linux operating systems

Diagnosis

The issue can be reproduced by following the steps below:

  1. Create a custom issue type with Korean characters in Jira.
  2. Then add a Jira Chart macro using that custom field in Confluence.
  3. The custom issue type in the Jira Chart would be shown as garbled text on Confluence UI.
  4. Lastly, we can then check the installed fonts on Jira server with the following commands.
# fc-list
or
# find /usr/share/fonts

Cause

Korean fonts are not installed on the Jira server.

Solution

Try to install any Korean font package or copy the fonts into the OS default directory, e.g. /usr/share/fonts.

(info) For example, the following package can be installed in the Redhat/CentOS environment:

# rpm -ivh https://pkgs.dyn.su/el8/base/x86_64/baekmuk-ttf-batang-fonts-2.2-48.el8.noarch.rpm

Last modified on Jun 15, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.