Home » Hooks » post_thumbnail_html

The post_thumbnail_html hook is a powerful tool in WordPress that allows developers to modify the HTML output of the post thumbnail (also known as the featured image) in their theme. This hook is triggered whenever WordPress generates the HTML markup for the post thumbnail, giving developers the ability to customize its appearance or add extra functionality.

The post thumbnail is a crucial element in many WordPress themes as it is often used to display a representative image for a post or page. By utilizing the post_thumbnail_html hook, developers can tap into the process of generating the post thumbnail and make changes according to their specific needs.

Example usage:

Let’s say you want to add a custom CSS class to the post thumbnail image so that you can style it differently. You can achieve this by using the post_thumbnail_html hook. Here’s an example code snippet:

function custom_post_thumbnail_class($html, $post_id, $post_thumbnail_id, $size, $attr) {
    $html = str_replace('class="', 'class="custom-thumbnail ', $html);
    return $html;
add_filter('post_thumbnail_html', 'custom_post_thumbnail_class', 10, 5);

In this example, we’re creating a function called custom_post_thumbnail_class that accepts the post thumbnail HTML ($html) along with some other parameters. We’re using the str_replace function to add the CSS class custom-thumbnail to the existing class attribute of the post thumbnail. Finally, we’re returning the modified HTML.

By adding the add_filter function and specifying the post_thumbnail_html hook, we’re telling WordPress to apply our custom function to the post thumbnail HTML generation process. Now, whenever a post thumbnail is displayed, it will have the additional class custom-thumbnail, allowing you to style it differently using CSS.

Remember, the possibilities with the post_thumbnail_html hook are endless. You can not only modify classes but also add custom attributes, change image URLs, or even completely alter the HTML structure of the post thumbnail. So, explore this hook and make your WordPress theme even more dynamic and personalized.

Learn More on

Register an account to save your snippets or go Pro to get more features.