Что такое «Категория блоков»
Категория нужна только для навигации в интерфейсе. Она не влияет на работу блока, на его разметку или на то, где его можно использовать. Когда на сайте сотня блоков от ядра и нескольких плагинов, группировка позволяет быстро пролистать до нужного раздела, не вспоминая точное название для поиска.
Стандартные категории ядра
text— абзац, заголовок, список, цитата, таблица;media— изображение, галерея, видео, аудио, файл, обложка;design— колонки, группа, кнопки, разделитель, отступ;widgets— архивы, календарь, последние записи, шорткод, произвольный HTML;theme— блоки сайта и записи для шаблонов: заголовок записи, логотип, блок запроса;embed— вставки YouTube, Vimeo и других сервисов по ссылке.
Как зарегистрировать свою
Плагину с несколькими блоками удобно собрать их в отдельную группу. Её добавляют фильтром block_categories_all, а в block.json каждого блока указывают её slug:
add_filter( 'block_categories_all', function ( $categories ) {
array_unshift( $categories, array(
'slug' => 'acme-shop',
'title' => 'Блоки магазина',
'icon' => null,
) );
return $categories;
} );
Функция array_unshift() ставит новую группу первой в списке, обычное добавление в конец массива — последней. В блоке остаётся строка "category": "acme-shop".
Частые недоразумения
- Если указать в блоке несуществующую категорию, редактор выдаст предупреждение в консоли браузера, а блок окажется вне ожидаемой группы.
- Категории блоков и категории паттернов — разные списки. Паттерны группируются через
register_block_pattern_category(). - Найти блок по смыслу помогают не категории, а ключевые слова в поле
keywordsфайлаblock.json.
Категория, как и имя блока, задаётся при регистрации, но, в отличие от имени, её можно спокойно поменять в новой версии плагина: сохранённые записи от этого не пострадают. Сам список групп пользователь видит в библиотеке вставки блоков.
Связанные термины
Обновлено: 10 октября 2026

