Lucidchart Diagrams OnPrem for Confluence Server - Configuring Asian Fonts

NOTICE: Lucidchart will be ceasing support for Lucidchart OnPrem for Confluence on January 6, 2021. For more information, please contact Lucidchart at or refer to these FAQs.


To enable input of Chinese, Japanese and Korean characters in Lucidchart Diagrams OnPrem for Confluence Server, you need to download and install an additional font package. It is not included into the app package by default because of its size. Please follow these steps:

  1. Download the asian font package from the following locations:
    1. If using Lucidchart OnPrem app version 1.16.13 or newer download this file. We strongly recommend using one of these versions as they offer the best support of Asian fonts. 
    2. If using an older app version download this file.
  2. Unpack and host the archive contents via HTTP(S) within your corporate network. 
    The easiest way to do this is to unpack the archive on your Confluence Server instance and configure Tomcat (Confluence's built-in web server) to serve it.
     Download the archive into the Confluence Home directory, assuming it's located at /var/atlassian/application-data/confluence.
    user@server:/var/atlassian/application-data/confluence$ wget
    user@server:/var/atlassian/application-data/confluence$ unzip

    Then navigate to Confluence installation directory and edit conf/server.xml. Find the Host element with the attribute name="localhost" and add the following Context element: 

    <Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="false" startStopThreads="4">
        <Context docBase="/var/atlassian/application-data/confluence/asianFonts" path="/customFonts" />

    To make the fonts load faster, enable Gzip compression. To do this, find the 

    Connector element in server.xml andadd compressioncompressableMimeType and useSendfile 

    attributes with the following values:

      <!-- The below attributes enable compression: -->
    FYI: Compression will only work with the latest Asian fonts. 
    Note: You may be able to achieve better performance by using a standalone web server, see running Confluence behind Apache.  If hosting the font package from an origin different from your Confluence Server instance, you'll need to configure CORS.
  3. Verify that the custom font package is accessible by opening  https://<YOUR CONFLUENCE HOST>/customFonts/public.json  in your browser.
  4. Modify the asianFonts/public.json file from the archive, replacing every instance of the string PATH_TO_FONTS with the URL to the directory configured in the previous step. For example:
    sed -i "s~PATH_TO_FONTS~" public.json
  5. Navigate to Lucidchart OnPrem app configuration page, enable the "Use Custom Fonts" option and enter the URL to public.json file in the text input below:



  It is now possible to set a default font to use across your Confluence Server instance for all new Lucidchart diagrams. You can choose this font from the provided font list or from the additional fonts in the Asian Fonts bundle.

To set a default font for your Confluence instance, follow these steps;
  1. If you are using Asian fonts, follow the steps above to install the Asian fonts bundle (if you have not already)
  2. Select the font you would like to use as a default font. (If your primary language is Japanese we recommend you use Lucid JP)
  3. Click save.