Getting the thumbnail URL from getChildrenCategories()

Getting the thumbnail URL from getChildrenCategories()

August 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Getting the thumbnail URL from getChildrenCategories()

Resolving Category Thumbnail Image Issues in Magento

Are you facing challenges displaying subcategory thumbnail images in your Magento footer? You’re not alone! Many developers struggle with rendering category thumbnails using the getChildrenCategories() method. Let me walk you through a step-by-step solution to this common issue.

The Problem: Empty img src Attribute

The core problem lies in how Magento handles category thumbnail URLs. Here’s what often happens:

  1. You load a parent category and get its child categories using getChildrenCategories().
  2. In your loop, you try to access the thumbnail URL with $artisan->getThumbnailUrl(), but it renders an empty string.

This leads to broken image tags in your footer, resulting in missing thumbnails or completely blank spaces where images should be displayed.

A Failed Attempt: getThumbnailUrl()

Many developers initially try using getThumbnailUrl() as suggested by some outdated tutorials. However, this method doesn’t work because category thumbnails are stored differently than product images.

The solution provided in the question attempts to use getThumbnailUrl(), but it fails to properly construct the thumbnail URL:

<img src="<?= $artisan->getThumbnailUrl() ?>" />

The Solution: Constructing Thumbnail URLs Manually

To fix this, we need to manually construct the thumbnail URL by combining Magento’s base media URL with the category ID and thumbnail filename.

Here’s the corrected code snippet that works:

<?= Mage::getBaseUrl('media').'catalog/category/'.$artisan->load($artisan->getId())->getThumbnail() ?>

Let me break down this solution:

  1. Mage::getBaseUrl('media'): This retrieves the base URL for your media directory.
  2. 'catalog/category/': This is the path where category thumbnails are stored.
  3. $artisan->load($artisan->getId())->getThumbnail(): We reload the category object to ensure we have access to its thumbnail filename.

By combining these elements, we create a complete URL that points directly to the category’s thumbnail image in the media directory.

Proper Image Attributes

In the solution provided, you’ll also notice proper width and height attributes are added to the <img> tag:

<img src="<?= Mage::getBaseUrl('media').'catalog/category/'.$artisan->load($artisan->getId())->getThumbnail() ?>" width="96" height="96" />

These attributes ensure that the thumbnail is displayed at a consistent size, improving the visual appearance of your footer.

Conclusion

Displaying category thumbnails in Magento requires careful handling of URLs. By manually constructing the thumbnail URL and using proper image attributes, you can successfully render subcategory images in your footer or other custom templates.

Remember to always keep your code clean and formatted properly for better readability and maintainability. If you’re looking for more advanced techniques for working with categories, check out our detailed guide on managing categories in Magento.

Happy coding!

Catalog Errors

Our network