CMS image is not showing properly with WYSIWYG

CMS image is not showing properly with WYSIWYG

August 5, 2026 · Illustrated author avatarBy Stefan Bogdanescu
CMS image is not showing properly with WYSIWYG

Solving Image Display Issues with WYSIWYG Editors in Magento

When working with Content Management Systems (CMS) like Magento, you may encounter issues while using the built-in WYSIWYG (What You See Is What You Get) editor to insert images. One common problem is when the image paths generated by the editor are too long or formatted incorrectly.

Understanding the Image Path Issue

The issue arises due to how Magento handles symlinks and media URLs in its file system structure. When you upload an image using the WYSIWYG editor, it creates a symlink (shortcut) for the image in your media directory and then adds this complex path to the HTML code.

Here’s an example of the incorrect long path:

<img src="media url=&quot;home/magento/static/media/wysiwyg/people.png&quot;" alt="" />

And here is how it should be:

<img src="media url=wysiwyg/people.png" alt="" />

Identifying the Root Cause

The problem typically occurs when you’re working with a server environment that uses symlinks, as these create additional layers in the file path. This issue usually does not appear in your local development environment because it doesn’t use symlinks by default.

When you click to add an image via the WYSIWYG editor popup, Magento generates this complex URL:

https://server.magento.local/index.php/smladmin/cms_wysiwyg/directive/___directive/e3ttZWRpYSB1cmw9ImhvbWUvc2FuaWRpcmVjdC9zdGF0aWMvbWVkaWEvd3lzaXd5Zy9sb2dvLXBpbi5wbmcifX0,/key/acc4e19a8864aa88801f17ea0d3d8b3e/

Solving the Image Display Issue

To resolve this problem, you can follow these steps:

1. Enable Flat Catalog Product for Store Views

Go to Stores > Configuration > Catalog > catalog > Frontend and set “Use Flat Catalog Product” to Yes.

2. Update Your Base URL

Ensure your base URL in the Magento configuration is correct (System > Configuration > General > Web).

3. Verify File Permissions

Check that the necessary file permissions are set correctly for the pub directory and its subdirectories (media, static).

4. Reindex Your Catalog Data

Navigate to System > Index Management, select All and click Reindex.

Best Practices to Avoid the Issue

To prevent this problem in the future:

  1. Always use relative paths when configuring image URLs or inserting images via the WYSIWYG editor.
  2. Keep your Magento system up-to-date with the latest patches and versions.
  3. Ensure consistent file permissions and ownership across all environments.

Conclusion

Symlink-related issues can cause unexpected behavior in Magento, resulting in improperly formatted image paths when using the built-in WYSIWYG editor. By understanding the root cause and implementing the solutions outlined above, you can quickly resolve these problems and maintain a functional and efficient CMS system.

For more detailed guides on Magento development best practices, visit Laravel Company’s Magento Development Resources.

Admin Errors CLI

Our network