Senior Frontend Architect, 10+ років досвіду побудови production-проєктів на Next.js. Contentful Certified Professional (2024). Спеціалізація: React Server Components, headless eCommerce, інженерія Core Web Vitals.
Шукаєте гайд з headless Magento — і отримуєте їхню стіну, майже всі написані агенціями, чий бізнес — виставляти вам рахунок за години розробників. Це диктує, що вам кажуть: робити треба все, все складно, і відповідь завжди — ще години. Цей гайд написаний з іншого боку, тим, хто збирає вітрини, тож може дозволити собі прямоту: коли headless Magento окупається, коли ні й де ховається реальна ціна. Без зайвого жаргону і без спроб виставити все складнішим, ніж воно є.
Що взагалі означає headless Magento?
Ваш магазин — це дві системи, з'єднані разом. Magento — це бекенд: товари, ціни, склад, акції, замовлення й адмінка, де ваша команда працює щодня. Вітрина — половина з обличчям: лістинги категорій, картки товару, пошук, кошик і оформлення. У звичайному магазині Magento вони йдуть одним пакетом, і тема Luma вирішує, наскільки магазин швидкий і гнучкий. Headless їх розділяє. Ви залишаєте Magento недоторканим і замінюєте вітрину теми кастомним фронтендом, що бере дані з GraphQL-API Magento. Команда так само веде все з тієї ж адмінки Magento. Змінюється лише шар, на який дивиться покупець, а саме він і вирішує, як швидко вантажаться сторінки, як виглядає магазин і скільки відвідувачів справді купують.
Скільки насправді коштує повільний магазин на Magento?
Цифри не м'які. Власні дані Google, опубліковані на web.dev, показали: у сайтів, що проходять пороги Core Web Vitals, на 24 відсотки нижча частка відвідувачів, які йдуть зі сторінки до того, як вона взагалі завантажилася. Дослідження Portent виміряло бік конверсії: конверсія магазину падає приблизно на 4,42 відсотка з кожною зайвою секундою завантаження в перші п'ять секунд. Deloitte показав, що ефект працює й у зворотний бік, причому в масштабі, який має турбувати будь-кого, хто сидить на важкій темі: скорочення завантаження на десяту частку секунди зрушило роздрібну конверсію вгору на 8,4 відсотка. Тема Luma, обтяжена розширеннями й серверним PHP, — саме та вітрина, що втрачає ці секунди, і за моїм досвідом секунди йдуть на категоріях і карточках товару, там, де купівля й відбувається.
Найбільше це видно на великих каталогах, і Google публікує, скільки ремонт приніс деяким із них, у власній бібліотеці кейсів. Redbus звів CLS з 1,65 у нуль і повідомив про зростання мобільної конверсії на 80 — 100 відсотків. AliExpress покращив CLS десятикратно і LCP удвічі, отримавши на 15 відсотків менше відмов. Tokopedia зрізала LCP на 55 відсотків, і сесії стали довшими на 23 відсотки. Cdiscount провів Чорну п'ятницю після роботи над швидкістю і повідомив про 6 відсотків додаткової виручки. Це їхні магазини і їхні цифри, а не прогноз для вашого, але вони показують порядок величини, про який ідеться. Якщо Search Console вже вас позначає, як читати провалену оцінку Core Web Vitals розбирає, що насправді каже звіт, перш ніж ви витратите бодай копійку на переробку.
Adobe Commerce, Open Source чи Mage-OS: це змінює збірку
Magento — це не один продукт, і редакція, яку ви використовуєте, змінює те, що має зробити headless-збірка, особливо навколо stored value. Adobe Commerce постачає гіфт-картки й store credit, але не має чистого API, щоб створювати їх headless, тож цей розрив треба закривати. Open Source і Mage-OS взагалі не мають ні гіфт-карток, ні store credit, ні механізму нагород, тож інструмент доводиться давати цілком. Саме така деталь ніколи не потрапляє в презентацію продажів, а потім з'їдає два тижні всередині проєкту. Вітрина, зібрана під реальний Magento, закриває це невеликим модулем-компаньйоном на редакцію: одним для Adobe Commerce й одним для Open Source і Mage-OS, віддаючи ті самі маршрути, щоб фронтенду було байдуже, яка редакція стоїть за ним.
| Редакція | Вбудований stored value | Headless API створення | Що додає темплейт |
|---|---|---|---|
| Adobe Commerce | Гіфт-картки і store credit | Немає | Модуль Samcheek_HeadlessLoyalty для створення їх headless |
| Magento Open Source | Немає | Немає | Модуль Samcheek_TenderInstrument, що дає інструмент |
| Mage-OS | Немає | Немає | Модуль Samcheek_TenderInstrument, що дає інструмент |
Складні частини, яких немає в презентації продажів
Headless Magento складний не через вітрину. Він складний через шви, де вітрина зустрічається з бекендом, який ніколи не проєктувався як headless. Ось частини, що тихо з'їдають бюджет:
- Checkout. На відміну від Shopify, який передає оформлення своєму хостовому checkout, checkout Magento — ваш, цілком headless, включно з інтеграцією платіжного шлюзу. Це найбільший шматок роботи й той, що більшість гайдів проскакує. Тут же й найбільше грошей: Baymard оцінює середню частку покинутих кошиків у 70,22 відсотка, головною причиною називає неочікувані доплати при оформленні, її вказують 48 відсотків покупців, і оцінює виграш лише від кращого дизайну оформлення у 35,26 відсотка конверсії для середнього великого магазину. Володіти checkout — це робота, але це ж і можливість.
- Типізований GraphQL. Схема GraphQL у Magento велика й нерівна. Без кодогенерації й типізованого шару даних кожен запит — місце, де може сховатися рантайм-помилка. Повний гайд зі збірки Next.js commerce показує ту саму дисципліну від початку до кінця.
- SEO і канонічні URL. Headless-переробка — це місце, де позиції тихо вмирають, якщо метадані, карти сайту, розмітку і канонічні URL для варіантів товару не перенести точнісінько. Це непомітно, поки за місяць не впаде трафік.
- Гіфт-картки й лояльність як тендер, а не знижка. Оплата балами чи гіфт-карткою має зменшувати тендер, а не оподатковувану базу. Вважати це знижкою — означає недобирати податок з кожного замовлення, а це реальна відповідальність, не похибка округлення.
- Повернення і рефанди. Вітрина, що володіє checkout, має володіти й шляхом рефанда назад у Magento, а це вимагає адмін-токена й акуратної ідемпотентної обробки, щоб повтор ніколи не повернув гроші двічі.
- Продуктивність. Увесь сенс headless — швидкість, тож межі бандла, image pipeline і кешування треба проєктувати, а не припускати. Планка опублікована і конкретна: щоб пройти, Google хоче largest contentful paint менш як 2,5 секунди, interaction to next paint менш як 200 мілісекунд і cumulative layout shift менш як 0,1, причому виміряні за 75-м процентилем реальних візитів, а не в лабораторії. Помилитеся тут — і отримаєте headless-магазин, який якимось чином повільніший за тему, що ви залишили.
Як production-темплейт робить headless Magento
Сенс збирати на протестованому темплейті, а не з чистого репозиторію, простий: кожна зі складних частин вище вже зібрана, вже протестована і вмикається конфігом, тож гроші йдуть у ваш магазин, а не в переробку сантехніки. Темплейт headless-комерції працює з Magento по GraphQL з кастомним checkout, типізованим шаром даних, вбудованим SEO і тендером гіфт-карток і лояльності за редакцією Magento. Та сама вітрина працює і на Shopify зміною одного значення конфігу, тож платформа лишається рішенням, до якого можна повернутися пізніше, а не стіною, об яку будуєшся. Він іде з 460+ автотестами, доступністю WCAG 2.2 AA, що перевіряється на кожній зміні, гейтами Lighthouse за продуктивністю і SEO і зв'язкою Docker плюс Redis для кількох реплік за балансувальником. Подивитися в роботі можна на живому демо.
- Швидкі сторінки за замовчуванням. Core Web Vitals у зеленій зоні й гейти Lighthouse у CI, що тримають їх такими, щоб швидкість, за яку ви заплатили, не осипалася тихо після запуску.
- Ваш Magento недоторканий. Товари, замовлення, акції й адмінка лишаються рівно там, де команда вже працює. Змінюється лише вітрина.
- Гіфт-картки й лояльність зроблені правильно. Обробляються як справжній тендер за редакцією, з невеликим модулем-компаньйоном для Adobe Commerce й одним для Open Source чи Mage-OS, тож фронтенд однаковий на обох.
- Дизайн повністю ваш. Колір, типографіка й відступи живуть у токенах, а не всередині компонентів, тож ребрендинг це файл значень, а не прохід по всіх стилях.
- Одна вітрина, будь-який бекенд. Той самий магазин працює на Magento чи Shopify, тож майбутня зміна платформи не означає викинути вітрину.
Коли headless Magento не виправданий
Є варіант відповіді, який нічого не коштує: не робити. Якщо Luma малює ваш каталог достатньо швидко, польові дані зелені, а дизайн робить те, що просить маркетинг, фронтенд не є тим, що тримає магазин, і замінювати його означає купити собі обслуговування замість продажів. Те саме з молодим магазином, де каталог тонкий, а трафіку мало: там обмеження в тому, щоб зрозуміти, що взагалі купують, і шар рендерингу на це не відповідає. Сигнал до дії вужчий, ніж обіцяє продаж: вітрина, яка у ваших власних цифрах виглядає стелею. Чесний кошторис каже про це раніше, ніж починає про архітектуру. Якщо хочете такий розбір щодо свого магазину, безкоштовний аудит сайту поверне ваші польові дані й проблеми сторінок за ними для будь-якого URL, а розбір headless-архітектури покриває глибшу роботу з рендерингом і взаємодією.
Чи працюватимуть мої розширення Magento після переходу на headless?
Залежить від того, за яку половину розширення ви насправді платите, і розподіл тут чистіший, ніж заведено думати. Усе, що працює за адмінкою, продовжує працювати без змін: синхронізація з ERP і обліком, податкові рушії, серверна обробка платежів, інструменти імпорту, звітність, логіка складу й залишків. Ніщо з цього ніколи не знало, що вітрина існує. Усе, чия цінність - намальований інтерфейс, не виживає, бо headless-вітрина ніколи не вантажить шаблон Luma, і PHTML-файлам, layout XML та Knockout-віджетам просто нема до чого причепитися. Бюджет вирішує середня категорія: розширення, які додають дані до товарів або замовлень і чекають, що фронтенд їх покаже. Корисна перевірка - власне правило Adobe. Модуль зобов'язаний покласти файл schema.graphqls у свою теку etc, щоб визначити запити й указати на резолвери, і Adobe зазначає, що якщо всі атрибути модуля - це extension attributes для вже наявних модулів, окреме визначення запиту не потрібне. Розширення, зроблені так, часто переїжджають узагалі без роботи. Тим, хто ніколи не виставляв GraphQL назовні, цю поверхню треба написати, і це рядок у кошторисі, який рахують до старту проєкту, а не виявляють на другий місяць.
- Переїжджає без змін: Синхронізація з ERP, обліком і PIM; розрахунок податків; серверні платіжні шлюзи; адмінські та звітні інструменти; логіка складу й залишків; усе, що крутиться на cron.
- Не виживає: Розширення теми; page builder'и, прив'язані до Luma; фронтові слайдери, попапи та мега-меню; усе, чий результат - PHTML-шаблон або Knockout-компонент. Вітрина перезбирає цю поведінку у своїх компонентах.
- Перевіряти по одному: Розширення, що додають кастомні атрибути товару, кастомні поля замовлення, баланси лояльності, B2B-правила цін або повідомлення про залишки. Спитайте вендора, чи постачає модуль GraphQL-схему, і якщо ні, резолвери комусь доведеться написати.
- Зробіть інвентаризацію до того, як брати кошторис: Вигрузіть список модулів з адмінки, розкладіть по цих трьох кошиках і рахуйте лише третій. Цей список зазвичай помітно коротший за тривогу навколо нього, і це єдина частина вашого парку розширень, переїзд якої коштує грошей.
PWA Studio від Adobe - безпечніший вибір, ніж кастомний фронтенд?
Це реальний варіант, і він не закинутий, що б ви не читали. Останній реліз PWA Studio у власному репозиторії Adobe - v14.5.1 від травня 2026 року, тож фраза «PWA Studio мертвий», яка ходить агентськими блогами, просто застаріла. Справжній вибір не про виживання, а про відповідність. PWA Studio віддає вам React-вітрину, яку підтримує Adobe, з уже підключеним шаром даних Magento, що знімає великий кусок інтеграційної роботи й лишає вас усередині стека, який Adobe підтримує. Взамін ви берете на себе його домовленості: структура компонентів Venia та хуки Peregrine належать PWA Studio, а не React як такому, через що звужується коло розробників, здатних швидко в ньому рухатися, а дизайн, що відходить від дефолтної теми, коштує дорожче, ніж здається. Кастомна вітрина на Next.js перевертає обидві сторони: інтеграцію ви будуєте самі, зате будь-який найнятий React-розробник уже знає ідіоми цього коду.
- PWA Studio пасує, коли: Ви на Adobe Commerce, хочете лишитися всередині підтримуваного вендором стека, ваш дизайн близький до звичайної комерційної розкладки, і у вас є або наймуться люди, які знають його домовленості.
- Кастомна вітрина пасує, коли: Дизайн - ваша відмінність, потрібен контроль над рендерингом, щоб тримати Core Web Vitals, потрібна можливість змінити комерційний бекенд пізніше, або ви радше наймаєте із загального React-ринку, а не з нішевого.
- Шви однакові в обох випадках: Чекаут, податок на оплату подарунковою карткою, повернення та канонічні URL складні тому, що бекенд - Magento, а не через фронтенд-фреймворк. Готовими їх не віддає жоден фреймворк.
- Твердження, якому не варто вірити: Хто каже вам, що один варіант мертвий, а інший - короткий шлях, той щось продає. Перевірте історію релізів самі, а потім вирішуйте за наймом і дизайном, бо вибір тримається саме на них.
Чи допомагає headless Magento SEO та AI-пошуку?
Так, коли зроблено правильно, і з двох причин. Google ранжує з огляду на зручність сторінки, тож вітрина, яка проходить Core Web Vitals там, де Luma не проходила, знімає штраф, що його тема накладала на кожну вашу позицію. Друга причина в тому, що передбачувану семантичну розмітку асистент здатен розібрати й процитувати, а дедалі більше рішень про купівлю тепер починається з питання до нього, а не з гортання десяти синіх посилань. Що варто знати, перш ніж вам продадуть «AI-пакет»: документація Google по AI-функціях каже, що додаткових вимог і особливої розмітки немає, потрібні лише сторінки, які проіндексовані, доступні для обходу і тримають вміст справжнім текстом. Тобто та сама інженерія, а не окремий продукт. Застереження в тому, що недбала headless-переробка може, навпаки, вбити SEO, втративши канонічні URL і розмітку, тож їх перенесення тут — основна робота, а не думка наостанок. Для ширшої технічної картини архітектура enterprise-комерції розбирає, як частини складаються на масштабі.
Чи можу я лишити Magento і все одно отримати швидку вітрину?
Саме це headless і дає. Ви лишаєте Magento як бекенд, а команда — звичну адмінку, тоді як звернена до покупця вітрина стає швидким кастомним фронтендом, що читає з Magento по GraphQL. У тому, як ви ведете бізнес, нічого не змінюється. Дорога, звернена до покупця половина магазину модернізується без ризикованої міграції платформи, і, оскільки та сама вітрина працює і на Shopify, ви не замкнені, навіть якщо пізніше зміните бекенд під нею. Можна подивитися production-кейси, щоб побачити підхід у контексті.
Як це реально отримати?
Почніть з живого демо і темплейта headless-комерції, щоб побачити, що входить у готову збірку. Якщо підходить, темплейт підключається до вашого Magento і запускається за години, а не за місяці, бо складні частини вже зібрані й протестовані. Коли будете готові обговорити свій магазин, редакцію й обмеження, зв'яжіться, і ми розберемо, чи headless правильний вибір для вас прямо зараз, чи у поточної теми ще є запас.
