Что такое «Категория блоков»

Категория нужна только для навигации в интерфейсе. Она не влияет на работу блока, на его разметку или на то, где его можно использовать. Когда на сайте сотня блоков от ядра и нескольких плагинов, группировка позволяет быстро пролистать до нужного раздела, не вспоминая точное название для поиска.

Стандартные категории ядра

  • 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

Все термины раздела «WordPress» ↗