> For the complete documentation index, see [llms.txt](https://www.one.thezero.club/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.one.thezero.club/guide/theme-extending/adding-new-content-block-layout-builder.md).

# Adding new Content block (Layout Builder)

Content blocks are used in many places, primarily in Layout Builder, but also in Page Builder content blocks (inside the Grid block, for example), in articles, Default template page, and other places.

### Creating new Content block

To add a new Content block you must do the next steps:

1. Add new block blueprint: **site/theme/blueprints/blocks/yourblockname.yml**
2. Add new block snippet: **site/theme/snippets/blocks/yourblockname.php**
3. After that just code that files, to do what you want them to do

### Including new Content block

To include your new block to be available inside the panel:

* If you want to add that block to **Layout Builder**
  * Copy **site/plugins/zero-one/blueprints/sections/layout-builder.yml** to **site/theme/blueprints/sections/layout-builder.yml** and add your block name to the fieldsets blocks list
* If you want to add that block to Content blocks fields throughout the website:
  * Copy **site/plugins/zero-one/blueprints/fields/blockEditor.yml** to **site/theme/blueprints/fields/blockEditor.yml** and add your block name to the fieldsets blocks list
* If you want that block to the Article template
  * Copy **site/plugins/zero-one/blueprints/pages/article.yml** to **site/theme/blueprints/pages/article.yml** and add your block name to the fieldsets blocks list

And that's it. Your custom block will be available. Only, it will have the default simple preview in the panel. If you want to create a better block preview you will have to create a simple plugin for that. Check this [Kirby docs Cookbook recipe](https://getkirby.com/docs/cookbook/panel/custom-block-type) and check **site/plugins/zero-one/index.js** on how we built some previews.