Get a Free Consultation

    Search for:

    How to add product image in Woocommerce programmatically?

    Last Updated | April 24, 2024

    Do you want to enhance your items using images? How you exhibit your items—whether it’s a featured image, a gallery, or both—will affect how many you sell. We’ll demonstrate how to add product image in WooCommerce programmatically and how to get product image in WooCommerce so that you can boost your sales!

    WooCommerce B2B Solution offers two primary methods for including photos with products:

    1. Add an Image through WooCommerce Dashboard
    2. Add an Image WooCommerce Programmatically

    Let’s plunge deep into both approaches.


    Adding An Image For A Product In WooCommerce 

    We will start with the approach that is to add an image through the WooCommerce dashboard.

    • Adding Images To Your Store Through WooCommerce Dashboard

    On a WooCommerce store, adding a picture to a product is a rather easy process. The picture meta fields can be found on the sidebar while creating or editing a product.

    1. There, you can display your things with a prominent image and an image gallery with several different images.
    2. Any of these will open a modal when you click it, allowing you to upload fresh image files or select an existing one from the WordPress media library.

    When uploading photographs to the product gallery, 

    1. CTRL + left click, you can pick multiple images and add them all at once.

    How to add product image in Woocommerce programmatically

    Image Credit: Quadlayers

    Alternatively, you can also use pictures from the product’s content description.

      1. Click the Add Media button and select the images you want to add. 

    Image Credit: Quadlayers

    If you want to employ this technique, bear in mind that your decision may have an impact on the entire product page’s design. As a result, before adding any photos to the text editor, make sure they are the proper size and alignment.

    You see, it is really very simple to add images of the products to your WooCommerce store from the dashboard. However, we have already mentioned that there are two ways to add images on WooCommerce.

     If you want to roll your sleeves up and setup a WooCommerce Store from   Scratch, there’s a step-by-step guide on how to setup WooCommerce store.

    The other way is to add images to WooCommerce programmatically if you know how to code, which provides you greater freedom. Let’s have a look at this one, Shall we!

    • Adding An Image WooCommerce Programmatically

    You might occasionally need to programmatically add images. More options are available to you thanks to this, including galleries, single-product photos, feature shots, and more.

    We’ll provide some sample scripts in this area to assist you to add photos to particular products. Keep in mind that you must change the item and picture IDs on the function’s first two lines with your own. You will see an error if the specified item and picture ID don’t exist.

    Read: 20 advanced ways to optimize and speed up WooCommerce store in 2022

    Additionally, remember that now the scripts will only function for one run. This implies that after using them, you can erase them.

    The last step is to insert the scripts into your child theme’s functions.php file. 

    Go to Appearance > Theme Editor. 

    Find the functions.php file in the right column, then paste the code there as described under the next heading below. A plugin like Code Snippets is an alternative.

    Note: Please, it is advisable that you make a backup of your website as you will be editing certain fundamental files. 

    • Add A Featuring Image To One Product

    1. Specify the image ID and product ID as shown below. 

    For instance, to set the image with ID 69 as the featured image of the product with ID 198.

    function QuadLayers_add_featured_image() {
        $imageID = 69; // Image ID
        $post_id = 198; //Product ID
        set_post_thumbnail( $post_id, $imageID );
    add_action('init', 'QuadLayers_add_featured_image');

    Every time a page loads, the function may be performed everywhere thanks to the init hook. Additionally, we set the featured picture using the set post thumbnail() function. Both posts and products can use this.

    Related Articles:
    1) WooCommerce Security
    2) Woocommerce Audit
    3) WooCommerce features

    • Add A featuring Image To More Than One Product

    Now to add a featured image to multiple products you need to repeat the same process. 

    1. Specify the image ID and product IDs (of products you are adding the image to) as shown below. 

    The following script shows script will add the image with ID 52 to products with IDs 36, 37, and 38.

    function QuadLayers_multiple_featured_image() {
        $imageID = 52; // Image ID
        $post_id = array(36,37,38); //Product IDs
        for ($ii=0; $ii < count($post_id); $ii++) { 
               set_post_thumbnail( $post_id[$ii], $imageID );      
    add_action('init', 'QuadLayers_multiple_featured_image');

    As you can see, we’ve added all of the product IDs to an array while keeping the script otherwise unchanged. You can do this to simultaneously allocate the very same featured image to multiple goods.

    This may be advantageous for product modifications that don’t result in cosmetic adjustments. Use the same featured image, for instance, for versions of the very same mobile phone but various RAM sizes.

    To speed up WooCommerce checkout process for the WooCommerce store, use the recommendations in this article.

    • Add images To Item Gallery 

    Adding an image to a product gallery in WooCommerce is slightly more complex because you need to use two functions. 

    1. The mentioned script prepares the data for the function (QuadLayers_create_gallery) required for creating create the gallery. ( list of images and the product ID where you wanted to be added to the gallery)
    2. The update_post_met() creates the gallery. To create this, you are required to utilize the ID of the product for adding to the gallery and a list of images in an array.
    function QuadLayers_create_gallery(){ 
            $imgs_ids=array(48,53,47); //image IDs
            add_img_to_gallery(195,$imgs_ids); // product id
    function add_img_to_gallery($product_id,$image_id_array){
            update_post_meta($product_id, '_product_image_gallery', implode(',',$image_id_array));
    • Setting A Default Image To Products 

    We’ve seen that to set the featured image of a product.

      1. Go to the admin dashboard, WooCommerce > Settings > Products.
      2. To set a default image WooCommerce programmatically, use the snippet mentioned below.

    add_filter('QuadLayers_default_image', 'custom_woocommerce_placeholder_img_src');
    function QuadLayers_default_image( $src ) {
    $upload_dir = wp_upload_dir();
    $uploads = untrailingslashit( $upload_dir['baseurl'] );
    // replace with path to your image
    $src = $uploads . '/2021/07/album-1.jpg';
    return $src;

    All the products lacking featured images will thereafter receive a default image. Remember to change it with the appropriate path to your image since you will use the image path here rather than an ID.

    To get the path, 

    1. Go to the Media library
    2. Search the image
    3. Copy the URL path 
    4. Paste in the code mentioned above, and keep the format the same.

    Also Read: Why the Scalability of WooCommerce is So Important?

    Which Method Is More Appropriate For You?

    Learn a little about the WooCommerce conversion rate.

    Two different approaches to adding an image to a WooCommerce product have been covered in this guide:

    1. Add an Image through WooCommerce Dashboard
    2. Add an Image WooCommerce Programmatically

    Adding an image from the dashboard is an excellent alternative because adding an image from the dashboard is really simple and easy to do without having any technical knowledge.

    However, you may also add photos to your WooCommerce programmatically if you have coding knowledge and prefer more flexibility. We’ve demonstrated a few scripts that make it simple for you to include galleries, featured photos, and images in your items.

    Also Read: How Many Products Can WooCommerce Handle?

    Final Words

    Adding images to your WooCommerce design is essential but how you want to add these images to your stores depends on what you want, ease and convenience or flexibility. To make the decision much easier for you, we have described both the methods; one with ease and convenience, and two with flexibility.

    We know there are people who like challenges and will use WooCommerce programmatically image addition path; rather than opting for the first. Now that you have learned how to add product image in WooCommerce programmatically and how to get product image in WooCommerce, it will help you improve your customer experience and consequently boost consumer engagement and sales.

    Feel free to contact Folio3 for any help you require regarding WooCommerce development, WooCommerce Migration, or any other eCommerce platform like BigCommerce web design company, Salesforce commerce cloud development, and more.



    How do I add a product image in WooCommerce?

    There are two ways with which you can add an image to your WooCommerce store’s products;

    1. Add an Image through WooCommerce Dashboard
    2. Add an Image WooCommerce Programmatically

    How do you update product images in WooCommerce programmatically?

    To update single product images, follow these steps:

    1. Select Customize from Appearance.
    2. Go to WooCommerce > Product Images after that.
    3. In the “Main image width” field, enter the width you desire.
    4. Select “Publish.”

    How do I add a product in WooCommerce programmatically?

    You only need to construct the post with the product details using the wp insert post() method and specify that the post you insert into the WordPress database should be in the product custom post type in order to create products in WooCommerce programmatically.

    The wp insert post() array field where you specify the custom post type is the most crucial element of the code. Simply, add the code to your function added to the functions.php or to the plugin files for creating a product on WooCommerce programmatically.

    How do I display images in WooCommerce?

    Just follow the simple steps and should be done in 5 minutes;

    1. Go to Appearance > Customize.
    2. Then WooCommerce > Product Images.
    3. Write your desired width in the “Thumbnail width” field.
    4. Set the height of the images in “Thumbnail Cropping”
    5. Click on “Publish”


    Folio3, a Software Powerhouse established in 2005, is one of the leading eCommerce solution providers for SMBs and Fortune 500. The Company has expertise in diverse industries such as Animal Care, Retail, Automotive, Food and Agriculture, and Health care. From ecommerce store design and development to full-scale ERP deployment and integration, Folio3 has done it all.