Shopify 8 октября объявила новое требование к метаполям расширений checkout и аккаунтов покупателей. С API 2027-01 каждая декларация метаполя должна содержать owner_type; без него публикация расширения будет заблокирована. Для команды магазина это задача подготовки приложения к обновлению версии, а не причина немедленно менять рабочую витрину.

Что обозначает owner_type

Поле указывает ресурс, которому принадлежит метаполе, например PRODUCT или CUSTOMER. Его добавляют в декларации файла shopify.extension.toml. На API 2026-10 возможность уже поддерживается, а обязательной становится с 2027-01. Расширения, которые вообще не объявляют такие метаполя, требование не затрагивает.

Если одинаковые namespace и key нужны для нескольких типов ресурсов, Shopify предлагает отдельную декларацию для каждого owner_type. Это помогает точнее ограничить получение данных. Подмена реального владельца любым допустимым значением ради успешной валидации не решает задачу.

Как установить, затронут ли магазин

Редакция рекомендует запросить у поставщиков перечень расширений оформления и личного кабинета, используемую версию API и наличие объявленных метаполей. Не требуйте правку от каждого установленного приложения: зависимость должна быть подтверждена его конфигурацией.

Для собственного расширения составьте простую карту: элемент интерфейса, используемое поле и ресурс-владелец. Например, сведения о товаре и предпочтение покупателя могут иметь похожее имя, но относятся к разным объектам. Такая карта пригодится и разработчику, и сотруднику, который принимает экран.

Что проверить до смены версии

Сначала добавьте корректные объявления на поддерживаемой версии и проверьте публикацию без ошибок валидации. Затем откройте те места, где расширение показывает или использует данные. Сам успешный выпуск не доказывает, что нужные значения поступили из правильного ресурса.

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

Как согласовать релиз с командой

Запишите целевую версию API, исполнителя и подтверждённые сценарии. Планировать стоит по реальному обновлению расширения: обозначение 2027-01 — версия интерфейса, а не автоматическое обещание отключить каждый магазин в один календарный день.

При работе в редакторе checkout с Sidekick различайте настройки экрана и конфигурацию кода расширения. Исправление поля в файле может потребовать разработчика приложения. Завершённая подготовка включает корректный owner_type, успешную публикацию и проверенное отображение данных, после чего обновление версии становится контролируемой операцией.