WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

block_template_part()

block_template_part( string $part )

In this article

Back to top

Prints a block template part.

Parameters

$partstringrequired
The block template part to print, for example 'header' or 'footer'.

Source

function block_template_part( $part ) {
	$template_part = get_block_template( get_stylesheet() . '//' . $part, 'wp_template_part' );
	if ( ! $template_part || empty( $template_part->content ) ) {
		return;
	}
	echo do_blocks( $template_part->content );
}

View all references View on Trac View on GitHub

UsesDescription
get_block_template()wp-includes/block-template-utils.php

Retrieves a single unified template object using its id.

do_blocks()wp-includes/blocks.php

Parses dynamic blocks out of post_content and re-renders them.

get_stylesheet()wp-includes/theme.php

Retrieves name of the current stylesheet.

Used byDescription
block_header_area()wp-includes/block-template-utils.php

Prints the header block template part.

block_footer_area()wp-includes/block-template-utils.php

Prints the footer block template part.

Changelog

VersionDescription
5.9.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Carolina Nymark
    You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

    Note that this outputs the content of the template part, and does not use any parameters added to the template part itself.

    In other words,
    If you have a template part, and you are adding it inside a HTML block template in a block theme with these parameters:

    wp:template-part {"slug":"footer","tagName":"footer","className":"site-footer"}

    Using block_template_part() to output the same template part in a PHP template, does not output the wrapping footer element and the site-footer CSS class.

You must log in before being able to contribute a note or feedback.