Confluence UI shows garbled or corrupt text on CAPTCHA, macros and/or diagrams due to missing fonts

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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

Problem

Following a Confluence upgrade running on an older Linux distribution, you might encounter a problem where certain system text in the application will appear to be garbled and look like symbols instead of regular alphanumeric letters.

You will not see any errors in the logs relating to the issue, however, you might see warnings about fonts in general.

This has been observed in the following areas of Confluence

CAPTCHA

(Auto-migrated image: description temporarily unavailable)

Macro headers

(Auto-migrated image: description temporarily unavailable)

Inline charts and diagrams

(Auto-migrated image: description temporarily unavailable)

Imported Microsoft Word Documents

(Auto-migrated image: description temporarily unavailable)

Diagnosis

In order to identify whether you are affected by this issue, you will need to answer the below questions:

  • Did you upgrade Confluence Server recently to a new version?

  • Are you running an older version of a Linux distribution that is behind current release cycle (possibly more than 3+ years old)?

Cause

If you answered yes to both of the above questions, you might be missing fonts on the OS level that more recent versions of Confluence depend on to render pages properly. Bug report for reference: CONFSERVER-54067 - Confluence UI shows garbled or corrupt text on CAPTCHA, macros and/or diagrams due to missing fonts in Linux

Solution

Resolution

Resolution 1

Uninstall lyx-fonts package (Lyx/MathML fonts - A collection of Math symbol fonts for lyx)

Resolution 2

You will need to check and install the following font packages. You can use any package manager you like. For this example, we will be using yum

1 2 3 4 5 yum install ghostscript yum install dejavu-fonts-common yum install dejavu-sans-fonts yum install dejavu-sans-mono-fonts yum install motif

Some versions of ghostscript packages can be affected by security vulnerability CVE-2018-16509 discovered in September 2018.

for more details see

In order for Confluence to pick up the changes, please apply the below steps:

  1. Stop Confluence

  2. Rebuild the font cache by using the following command:

    1 fc-cache -s
  3. Clear the How to clear the apps (plugins) cache in Confluence Data Center.

  4. Perform a How to Rebuild the Content Indexes From Scratch on Unclustered Confluence.

  5. Start Confluence.

  6. Clear your browser cache and verify Confluence is presenting the text properly.

  7. If you still see garbled text, try rebooting the server, then check again.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.