{"id":82753,"date":"2023-04-04T07:42:33","date_gmt":"2023-04-04T07:42:33","guid":{"rendered":"\/tutorials\/?p=82753"},"modified":"2025-04-26T02:58:18","modified_gmt":"2025-04-26T02:58:18","slug":"wp_get_attachment_image","status":"publish","type":"post","link":"\/in\/tutorials\/wp_get_attachment_image\/","title":{"rendered":"How to Use the wp_get_attachment_image Function in WordPress + Useful Examples"},"content":{"rendered":"

The wp_get_attachment_image<\/strong> is a WordPress function that lets you easily retrieve and display image attachments based on their IDs.<\/p>

Whether you’re building a custom theme or a plugin, this function provides a flexible way to display images with custom sizes and attributes.<\/p>

In this tutorial, we’ll go over the wp_get_attachment_image()<\/strong> function and explain its parameters. We’ll also provide a few popular use cases you can test on your WordPress website.<\/p>

Download all in one WordPress cheat sheet<\/a><\/p>

\n\n\n\n\n\n\n<\/p>

Parameters of the wp_get_attachment_image Function<\/h2>

The wp_get_attachment_image()<\/a> function lets users retrieve an HTML img<\/strong> element for an image attachment.<\/p>

wp_get_attachment_image( int $attachment_id, string|int[] $size = 'medium', bool $icon = false, string|array $attr = '' );<\/pre>
By default, the wp_get_attachment_image() <\/strong>function requires at least one parameter, the attachment ID, which is the unique identifier for the image. The function then outputs the full-sized image without additional HTML attributes or customization.<\/p>
Furthermore, you can add various additional parameters for customizing the image output, such as the image size, CSS class<\/a>, or alt text:<\/p>
$attachment_id<\/strong><\/p>
This is necessary to specify the attachment image ID that will be displayed. If the parameter is empty or set to false<\/strong>, the function won’t return any image.<\/p>
$size<\/strong><\/p>
An optional parameter that defines the WordPress image size<\/a> to display. You can specify any registered image size name, for example, thumbnail<\/strong>, medium<\/strong>, large<\/strong>, <\/strong>or a custom size in pixels.<\/p>
$icon<\/strong><\/p>
Another optional parameter which determines whether the image should be treated as an icon. If set to true<\/strong>, the function will display the attachment icon instead of the actual image.<\/p>
$attr<\/strong><\/p>
This parameter lets you add more attributes to the image tag, such as a class or a style. You can pass an array of key-value pairs to add the following attributes:<\/p>