Check if product image is base image?

Check if product image is base image?

August 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Check if product image is base image?

Checking if an image is the base image for a product in Magento involves accessing the product’s image gallery data and examining specific attributes of the images within that gallery.

Understanding Base Images in Magento

In Magento, each product can have multiple images associated with it. The base image is typically the primary or main image used to represent the product on category pages, search results, and certain product listings. By default, Magento sets one image as the base image for each product during creation or update.

Accessing Product Images in Code

Firstly, let’s review how you’re currently accessing the images of a product using Magento’s built-in API:

Mage::getModel('catalog/product')
    ->load($prod->getId())
    ->getMediaGalleryImages()
    ->getItems();

This code loads the specified product and retrieves an array of all its gallery images. The getItems() method returns a collection containing details about each image, including attributes like file, label, position, etc.

Identifying Base Images

To determine if an image is the base image for a product, we need to check two key fields in the image data: disabled and position.

  1. Disabled attribute: The disabled field indicates whether the image should be shown or hidden on frontend views like category pages and search results. A value of 0 means it’s enabled (active), while 1 signifies that it’s disabled (inactive). By default, Magento sets the base image as active with a value of 0.
$isDisabled = $image->getData('disabled');
if ($isDisabled == 0) {
    // This is an active image
}
  1. Position attribute: The position field determines the order in which images are displayed on the product view page and other pages where all images are shown together (like a lightbox or gallery). Magento automatically sorts images based on this value, with lower numbers appearing first. By default, it sets the base image as the first one with a position of 0.
$position = $image->getData('position');
if ($position == 0) {
    // This is the first image in the list
}

Combining Conditions

To accurately identify the base image, you should combine both conditions:

  • The disabled attribute must be set to 0 (active).
  • The position attribute must be 0.

Here’s a function that encapsulates this logic:

function isBaseImage($image) {
    $isDisabled = $image->getData('disabled');
    $position   = $image->getData('position');

    if ($isDisabled == 0 && $position == 0) {
        return true;
    }

    return false;
}

Conclusion

Checking if an image is the base image for a product in Magento requires examining two key attributes: disabled and position. By ensuring that both conditions are met—disabled equals 0 (active) and position equals 0—you can accurately determine whether an image is set as the primary or main representation of the product.

Remember to use this approach when you need to identify and manipulate base images within your Magento extensions or customizations. Combining these checks into a reusable function, like the one demonstrated above, promotes code organization and maintainability in your projects.

For more advanced Magento development techniques and best practices, explore our comprehensive guides on https://laravelcompany.com/magento-development/.

Catalog API

Our network