Title: New directory names for block-based (FSE) themes
Author: Michael Burridge
Published: December 3, 2021
Last modified: December 6, 2021

---

 [  ](https://profiles.wordpress.org/mburridge/) [Michael Burridge](https://profiles.wordpress.org/mburridge/)
9:29 am _on_ December 3, 2021     
Tags: [block-based-themes ( 14 )](https://make.wordpress.org/themes/tags/block-based-themes/),
[Theme Documentation ( 6 )](https://make.wordpress.org/themes/tags/theme-documentation/)

# New directory names for block-based (FSE) themes

> **TL;DR:** 
> As of the currently available WordPress 5.9 BetaBeta A pre-release
> of software that is given out to a large group of users to trial under real conditions.
> Beta versions have gone through alpha testing in-house and are generally fairly
> close in look, feel and function to the final product; however, design changes
> often occur as part of the process. 1 release the directory names in blockBlock
> Block is the abstract term used to describe units of markup that, composed together,
> form the content or layout of a webpage using the WordPress editor. The idea combines
> concepts of what in the past may have achieved with shortcodes, custom HTML, and
> embed discovery into a single consistent API and user experience.-based (FSEFSE
> Short for Full Site Editing, a project for the Gutenberg plugin and the editor
> where a full page layout is created using only blocks.) themes are changing. The
> name for the directory containing template files will be `templates`, and the 
> name for the directory containing template part files will be `parts`.

WordPress 5.9 will be released on 25 January 2022 _(see the current release schedule
[here](https://make.wordpress.org/core/5-9/))_ and marks the arrival of block-based
themes, also known as full-site editing (FSE).

Developers who have already experimented with creating block-based themes during
the run-up to the release of 5.9 should note that the directory names for templates
and template parts are being changed.

Previously the names for the directories containing template files and template 
part files were:

 * `block-templates`
 * `block-template-parts`

With the release of 5.9 these will instead be:

 * `templates`
 * `parts`

This change is detailed in [PR #36647](https://github.com/WordPress/gutenberg/pull/36647).
The documentation in the [Block Theme Overview](https://github.com/WordPress/gutenberg/blob/trunk/docs/how-to-guides/themes/block-theme-overview.md)
and [Create a block theme](https://github.com/WordPress/gutenberg/blob/trunk/docs/how-to-guides/themes/create-block-theme.md)
pages has been updated to reflect this.

The rationale behind this change is that it creates a cleaner and clearer directory
naming paradigm that will simplify the addition of further directories in the future,
such as `styles` and `patterns` , should they be needed.

> For more insight into the rationale underlying this change please see issues [#34550](https://github.com/WordPress/gutenberg/issues/34550)
> and [#36548](https://github.com/WordPress/gutenberg/issues/36548).

This change is [backwards compatible](https://github.com/WordPress/gutenberg/blob/e5234418780871ccf848bdbf21d8dd9a67b6963b/lib/compat/wordpress-5.9/block-template-utils.php#L24)
and the old names will still continue to work, but **note** that the old and new
directory names are mutually exclusive and cannot be combined. You cannot call one
directory `block-templates` and the other `parts`, for example.

This change is already implemented in the currently available [Beta 1](https://wordpress.org/news/2021/11/wordpress-5-9-beta-1/)
release of WordPress 5.9.

 [#block-based-themes](https://make.wordpress.org/themes/tags/block-based-themes/),
[#theme-documentation](https://make.wordpress.org/themes/tags/theme-documentation/)

### Share this:

 * [  Threads ](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?share=threads)
 * [  Mastodon ](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?share=mastodon)
 * [  Bluesky ](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?share=bluesky)
 * [  Facebook ](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?share=facebook)
 * [  X ](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?share=x)
 * [  LinkedIn ](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?share=linkedin)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fthemes%2F2021%2F12%2F03%2Fnew-directory-names-for-block-based-fse-themes%2F%23respond&locale=en_US)

### Leave a Reply 󠀁[Cancel reply](https://make.wordpress.org/themes/2021/12/03/new-directory-names-for-block-based-fse-themes/?output_format=md#respond)󠁿

You must be [logged in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fthemes%2F2021%2F12%2F03%2Fnew-directory-names-for-block-based-fse-themes%2F&locale=en_US)
to post a comment.

This site uses Akismet to reduce spam. [Learn how your comment data is processed.](https://akismet.com/privacy/)

# Post navigation

[← Introducing new Themes Team representatives](https://make.wordpress.org/themes/2021/12/03/introducing-new-themes-team-representatives/)

[Gutenberg + Themes: Week of November 29th, 2021 →](https://make.wordpress.org/themes/2021/12/03/gutenberg-themes-week-of-november-29th-2021/)