Retrieving the HTML image tag for an attachment in WordPress using wp_get_attachment_image

The WordPress wp_get_attachment_image function is used to retrieve the HTML for an image attachment. It can be useful for dynamically displaying images on a WordPress site without having to manually write the HTML markup for each image.

By using the wp_get_attachment_image function, developers can easily fetch and display images from the media library, and customize the output using various parameters.

  • It can be used to retrieve the HTML for a specific image attachment by passing its ID as a parameter.
  • It can also be used to retrieve the HTML for a specific image size by passing the size name as a parameter.
  • Developers can further customize the output by passing additional parameters such as class, alt text, and caption.

The wp_get_attachment_image function simplifies the process of displaying images on a WordPress site and allows for easy customization of the image HTML markup.

Parameters Accepted by wp_get_attachment_image function

  • $attachment_id (int) – required. This is the Image attachment ID.
  • $size (string|int[]) – optional. Default value is ‘thumbnail’. This parameter specifies the image size. It accepts any registered image size name, or an array of width and height values in pixels (in that order).
  • $icon (bool) – optional. Default value is false. This parameter determines whether the image should be treated as an icon.
  • $attr (string|array) – optional. Default value is an empty string. This parameter specifies the attributes for the image markup.

Value Returned by wp_get_attachment_image function

The function returns a string HTML img element or an empty string on failure.


How to display the full-size image using wp_get_attachment_image

$image = wp_get_attachment_image( $attachment_id, 'full' );
echo $image;

This code snippet retrieves the full-size image for a given attachment ID using the wp_get_attachment_image function and then displays the image on the page.

How to display a custom size image using wp_get_attachment_image

$image = wp_get_attachment_image( $attachment_id, 'custom-size' );
echo $image;

In this example, we use the wp_get_attachment_image function to retrieve and display an image of a custom size, specified by the ‘custom-size’ parameter, for a given attachment ID.

How to display the image with additional attributes using wp_get_attachment_image

$image = wp_get_attachment_image( $attachment_id, 'thumbnail', false, array( 'class' => 'custom-image-class', 'alt' => 'Custom Alt Text' ) );
echo $image;

This code snippet demonstrates how to use the wp_get_attachment_image function to display an image with additional attributes, such as a custom CSS class and alternative text, for a given attachment ID and thumbnail size.


In conclusion, the wp_get_attachment_image function is an useful component for retrieving and displaying images attached to WordPress posts or pages. With its ability to generate HTML image tags with custom sizes, classes, and attributes, it offers developers a flexible and efficient way to work with media in their WordPress projects.

By utilizing the various parameters available, such as $attachment_id, $size, and $icon, developers can tailor the output of the function to suit their specific needs. Additionally, the function’s support for responsive images and custom image sizes makes it a valuable asset for creating visually appealing and user-friendly websites.

The wp_get_attachment_image function is a valuable addition to the WordPress developer’s toolkit, providing a seamless way to incorporate media into their projects while maintaining control over the presentation and behavior of the images.

Related WordPress Functions