{"pageProps":{"title":"post_thumbnail_html","titleType":"Hook","type":"hooks","content":"<article><h1>post_thumbnail_html <span>WordPress Filter Hook</span></h1><p class=\"main-description\">The post_thumbnail_html WordPress hook is a great way to change the way your post thumbnails look on your website. This hook allows you to change the HTML code that is output for your post thumbnails, which means you can change the size, shape, and style of your post thumbnails.</p><h2><span class=\"hook-func\">apply_filters</span>( 'post_thumbnail_html',  <nobr><span class=\"arg-type\">string</span> <span class=\"arg-name\">$html</span></nobr>,  <nobr><span class=\"arg-type\">int</span> <span class=\"arg-name\">$post_id</span></nobr>,  <nobr><span class=\"arg-type\">int</span> <span class=\"arg-name\">$post_thumbnail_id</span></nobr>,  <nobr><span class=\"arg-type\">string|int[]</span> <span class=\"arg-name\">$size</span></nobr>,  <nobr><span class=\"arg-type\">string|array</span> <span class=\"arg-name\">$attr</span></nobr> ) <a id=\"block-level-html-elements-by-default\" href=\"#post_thumbnail_html\">#</a></h2><section class=\"summary\"><p>Filters the post thumbnail HTML.</p></section><div class=\"content-toc\"><div class=\"table-of-contents\"><h2>Contents</h2><ul class=\"items\"><li><a href=\"#parameters\">Parameters</a></li><li><a href=\"#source\">Source</a></li><li><a href=\"#related\">Related</a><ul><li><a href=\"#used-by\">Used By</a></ul></li><li><a href=\"#changelog\">Changelog</a></li></ul></div><hr /><section class=\"parameters\"><h2 id=\"parameters\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#parameters\" class=\"dashicons-before dashicons-admin-links\">Parameters</a></h2><dl><dt>$html</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"string\">string</span>)</span><span class=\"description\">The post thumbnail HTML.</span></p></dd><dt>$post_id</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"int\">int</span>)</span><span class=\"description\">The post ID.</span></p></dd><dt>$post_thumbnail_id</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"int\">int</span>)</span><span class=\"description\">The post thumbnail ID, or 0 if there isn't one.</span></p></dd><dt>$size</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"string\">string</span>|<span class=\"int[]\">int[]</span>)</span><span class=\"description\">Requested image size. Can be any registered image size name, or                                        an array of width and height values in pixels (in that order).</span></p></dd><dt>$attr</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"string\">string</span>|<span class=\"array\">array</span>)</span><span class=\"description\">Query string or array of attributes.</span></p></dd></dl></section><hr /><section class=\"source-content\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"source\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#source\" class=\"dashicons-before dashicons-admin-links\">Source</a></h2><p>File: <a href=\"/reference/files/wp-includes/post-thumbnail-template.php\">wp-includes/post-thumbnail-template.php</a></p><p><a href=\"https://core.trac.wordpress.org/browser/tags/6.0/src/wp-includes/post-thumbnail-template.php#L232\">View on Trac</a></p></section><hr /><section class=\"related\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"related\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#related\" class=\"dashicons-before dashicons-admin-links\">Related</a></h2><article class=\"used-by\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h3 id=\"used-by\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#used-by\" class=\"dashicons-before dashicons-admin-links\">Used By</a></h3><table id=\"used-by-table\"><caption class=\"screen-reader-text\">Used By</caption><thead><tr><th>Used By</th><th class=\"related-desc\">Description</th></tr></thead><tbody><tr><td><span>wp-includes/post-thumbnail-template.php:</span><a href=\"/reference/functions/get_the_post_thumbnail\">get_the_post_thumbnail()</a></td><td class=\"related-desc\"><p>Retrieves the post thumbnail.</p></td></tr><tbody></table></article></section><hr /><section class=\"changelog\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"changelog\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#changelog\" class=\"dashicons-before dashicons-admin-links\">Changelog</a></h2><table><caption class=\"screen-reader-text\">Changelog</caption><thead><tr><th class=\"changelog-version\">Version</th><th class=\"changelog-desc\">Description</th></tr></thead><tbody><tr><td><a href=\"/reference/since/2.9.0\" alt=\"WordPress 2.9.0\">2.9.0</a></td><td>Introduced.</td></tr></tbody></table></section></div></article>","description":"Filters the post thumbnail HTML.","sidebarFiles":{"Hook":[{"componentTitle":"begin_fetch_post_thumbnail_html","componentLink":"/reference/hooks/begin_fetch_post_thumbnail_html","private":"","deprecated":""},{"componentTitle":"end_fetch_post_thumbnail_html","componentLink":"/reference/hooks/end_fetch_post_thumbnail_html","private":"","deprecated":""},{"componentTitle":"has_post_thumbnail","componentLink":"/reference/hooks/has_post_thumbnail","private":"","deprecated":""},{"componentTitle":"post_thumbnail_html","componentLink":"/reference/hooks/post_thumbnail_html","private":"","deprecated":"","active":"active"},{"componentTitle":"post_thumbnail_id","componentLink":"/reference/hooks/post_thumbnail_id","private":"","deprecated":""},{"componentTitle":"post_thumbnail_size","componentLink":"/reference/hooks/post_thumbnail_size","private":"","deprecated":""},{"componentTitle":"post_thumbnail_url","componentLink":"/reference/hooks/post_thumbnail_url","private":"","deprecated":""},{"componentTitle":"the_post_thumbnail_caption","componentLink":"/reference/hooks/the_post_thumbnail_caption","private":"","deprecated":""}],"Function":[{"componentTitle":"get_post_thumbnail_id()","componentLink":"/reference/functions/get_post_thumbnail_id","private":"","deprecated":""},{"componentTitle":"get_the_post_thumbnail_caption()","componentLink":"/reference/functions/get_the_post_thumbnail_caption","private":"","deprecated":""},{"componentTitle":"get_the_post_thumbnail_url()","componentLink":"/reference/functions/get_the_post_thumbnail_url","private":"","deprecated":""},{"componentTitle":"get_the_post_thumbnail()","componentLink":"/reference/functions/get_the_post_thumbnail","private":"","deprecated":""},{"componentTitle":"has_post_thumbnail()","componentLink":"/reference/functions/has_post_thumbnail","private":"","deprecated":""},{"componentTitle":"the_post_thumbnail_caption()","componentLink":"/reference/functions/the_post_thumbnail_caption","private":"","deprecated":""},{"componentTitle":"the_post_thumbnail_url()","componentLink":"/reference/functions/the_post_thumbnail_url","private":"","deprecated":""},{"componentTitle":"the_post_thumbnail()","componentLink":"/reference/functions/the_post_thumbnail","private":"","deprecated":""},{"componentTitle":"update_post_thumbnail_cache()","componentLink":"/reference/functions/update_post_thumbnail_cache","private":"","deprecated":""}]}},"__N_SSG":true}