Unable to Display Attached Images with Filenames with Special Characters

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

Symptoms

The error message appears in the UI when embedding an image:

Unable to render embedded object: File (<filename of the image>) not found.

Causes

This can be caused by either of the following:

  1. The tagLinks plugin causes this message for underscore and dash characters.

  2. A Confluence bug, CONFSERVER-13526 - Special Characters (#$%) in image file name cause broken images. causes this when # $ or % characters are in the file name.

Workaround

If using tagLinks, disable or uninstall the plugin. Note that this is not an Atlassian supported plugin.

If your file name uses the mentioned special characters, rename it.

Resolution

Track a resolution at CONFSERVER-13526 - Special Characters (#$%) in image file name cause broken images.

Updated on May 22, 2025

Still need help?

The Atlassian Community is here for you.