Magento custom Module - edit form small image preview and delete image checkbox issue

Magento custom Module - edit form small image preview and delete image checkbox issue

October 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento custom Module - edit form small image preview and delete image checkbox issue

Fixing Image Preview and URL issues in Magento Custom Modules

When developing custom modules for Magento, you may encounter challenges when working with image uploads and previews. In this post, we’ll address the common issue of incorrect image URLs being displayed during the edit form small-image-preview process.

Understanding the Problem: Incorrect Image URLs

The core problem lies in how Magento constructs the media URL. When you save an image to a custom folder like media/finder/images, the system expects the base URL to be set correctly. However, if the base URL is not configured properly (often set to the root media folder), the preview will display an incorrect URL.

This results in a broken image icon appearing in the small-image-preview field during the edit process.

The Current Situation: Incorrect URLs and Broken Images

In your controller code, you’re correctly moving the file to the finder/images folder. However, when editing an item, the system is referencing the incorrect base URL (media) instead of the expected custom URL with the correct path.

This discrepancy leads to the image preview displaying a broken icon because it’s unable to locate the image at the media folder level.

The Solution: Configuring Base URLs for Custom Image Folders

To resolve this issue, you need to ensure that Magento is aware of your custom image folder and its base URL. Here are the steps:

1. Define Your Custom Media Configuration XML

Create a new XML file in your module’s config directory, e.g., media.xml:

<config>
    <global>
        <media>
            <finder_images>
                <filesystem>
                    <directory>var/finder/images</directory>
                    <url_path>/finder/images/</url_path>
                </filesystem>
            </finder_images>
        </media>
    </global>
</config>

2. Update Your Module’s XML Configuration

In your module’s etc/config.xml file, include the new media configuration:

<config>
    <modules>
        <Finder_Core>
            <active>true</active>
            <codePool>local</codePool>
            <dependencies>
                <Finder_Adminhtml/>
            </dependencies>
        </Finder_Core>
    </modules>
    <global>
        <media>
            ...
            <finder_images>
                <filesystem>
                    <directory>var/finder/images</directory>
                    <url_path>/finder/images/</url_path>
                </filesystem>
            </finder_images>
        </media>
    </global>
    ...
</config>

3. Update Your Base URL in the admin panel

Log into your Magento admin panel and navigate to System > Configuration. Search for Base URLs under the Web section.

Ensure that:

  • Base URLs (Web): http://demo.com/magento/
  • Use Secure URLs: No
  • Add Store Code to URLs: No
  • Redirect to Base URL: Yes

4. Clear Cache and Re-index Data

After making these changes, clear your Magento cache and re-index all data.

The Result: Correct Image URLs and Preview Displays

By following these steps, you should now see the correct image URLs being used for the small-image-preview in your custom module’s edit form. The images will load correctly without displaying broken icons.

Remember that this solution requires understanding of Magento’s media configuration structure and proper folder permissions to ensure smooth operation.

For more detailed information on managing files and folders in Magento, consider reading our comprehensive guide at Laravel Company.

Conclusion

Resolving image preview issues in custom Magento modules requires careful configuration of media directories and base URLs. By following the steps outlined above, you can ensure that your images are correctly displayed during the edit form process.

If you continue to face challenges with custom module development or need further assistance, feel free to reach out to our team at Laravel Company. We’d be happy to help you optimize your Magento setup.

Extensions Configuration Errors

Our network