Jama allows users to add an image to a rich text field in two ways: by copy-and-paste and through the upload image button.
When using the copy-and-paste method, you should refrain from copying and pasting images alone or along with the rest of your text content as that will result in base64 encoded images. If you copy and paste to add images, you may face some of these issues:
- Due to the differences in how browsers handle base64 encoding, images may become distorted when exported.
- Since the image is stored as base64 encoded string that can be thousands of characters long, any filter that uses the field will be impacted as it needs to parse through all the extra characters.
- Additionally, due to the increase in characters being stored within the document and evententry tables, your database could run out of space if the copy-and-paste method is used at scale and over long periods of time.
- You might think that you added the image to the field but might end up adding just a link to it that looks like a normal image. The issue with having an image link is that although you may have access to it, your colleagues may not. This will also cause the image to be displayed as a broken link when you export the item.
- If you use an image with a resolution equal or higher than 1980p there is a high probability it will be distorted and exported as a line in Word documents.
As shown below you can identify an embedded image by looking at the source of the original document:
alt="Base64 encoded image" width="150" height="150"/>
You can check the source of an item in Jama by selecting the source button shown below.
As we work to solve the issues above, the current workaround is the usage of the image upload button as the image will be uploaded to the Jama server and then made available for viewing. Please refer to this article about the supported image format types
Additionally, when you upload an image into a rich text field using the API, the image will be uploaded as a base64 encoded image, and suffer the same problems as described above. #requirementsmanagement