Имя блока

По этому имени WordPress находит блок везде: в реестре зарегистрированных типов, в сохранённом тексте записи, в фильтрах PHP и в стилях. Первая часть — пространство имён, общее для всех блоков одного автора или плагина. У ядра это core, у WooCommerce — woocommerce, у собственного плагина — короткое слово вроде названия проекта. Вторая часть описывает сам блок. Так два плагина могут сделать блок «price», не мешая друг другу.

Правила записи

Обе части пишутся строчными латинскими буквами, цифрами и дефисами и начинаются с буквы. Пробелы, подчёркивания и заглавные буквы не допускаются, а имя без пространства имён зарегистрировать не получится. Имя задают в block.json:

{
  "apiVersion": 3,
  "name": "acme/price-card",
  "title": "Карточка цены",
  "category": "widgets"
}

Где имя встречается дальше

• В разметке записи: <!-- wp:acme/price-card -->. Для блоков ядра префикс опускается — <!-- wp:paragraph --> означает core/paragraph.
• В CSS-классе обёртки: для своего блока это wp-block-acme-price-card.
• В PHP: has_block( 'acme/price-card' ) проверяет, есть ли блок в записи, — удобно, чтобы подключать скрипты только там, где он нужен. Фильтр render_block_core/image меняет вывод только картинок.
• В ограничениях набора блоков — например, в фильтре allowed_block_types_all перечисляют именно имена.

Почему имя нельзя менять

Имя записано в каждой записи, где блок использован. Если в новой версии плагина переименовать acme/price в acme/price-card, редактор перестанет узнавать старые экземпляры и сообщит, что сайт не поддерживает такой блок. Поэтому имя выбирают один раз и навсегда, а для переходов пишут правила преобразования. То же происходит при удалении плагина: его блоки в записях остаются, но редактор показывает их как неизвестные.

Имя — только идентификатор. Всё остальное описание — атрибуты, поддержка функций, стили — относится к типу блока, а в библиотеке вставки блоки группируются по категориям, которые с именем никак не связаны.