---
title: How to activate headless mode in Magento 2
description: If you are using HYVA or have a headless theme, you need to Activate Headless Mode by following the steps below
---

[Skip to content](https://knowledge.profitmetrics.io/how-to-activate-headless-mode-in-magento-2#main-content)

[![ProfitMetrics logo black version](https://knowledge.profitmetrics.io/hs-fs/hubfs/pm_logotype_blue.png?width=193&height=28&name=pm_logotype_blue.png)](https://knowledge.profitmetrics.io/?hsLang=en)

Open main navigation

Close main navigation

- [Contact Support](https://knowledge.profitmetrics.io/kb-ticket/new)

[Contact Support](https://knowledge.profitmetrics.io/kb-ticket/new?hsLang=en)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://knowledge.profitmetrics.io/?hsLang=en)
2. [E-commerce Platforms](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en)
3. [Magento](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#magento)

# How to activate headless mode in Magento 2

## If you are using HYVA or have a headless theme, you will need to activate headless mode by following the steps below.

---

Part 1: [Activate Headless Mode in Magento](https://knowledge.profitmetrics.io/how-to-activate-headless-mode-in-magento-2#part1)

Part 2: Install the Server-side Hybrid Universal Integration tracking script on your website in one of two ways.

1. 1. [Install the Serverside Hybrid Universal Integration script](https://knowledge.profitmetrics.io/how-to-install-the-serverside-hybrid-universal-integration-script?hsLang=en) <https://knowledge.profitmetrics.io/how-to-install-the-serverside-hybrid-universal-integration-script?hsLang=en>
     2. [Install the Serverside Hybrid Universal Integration script in Google Tag Manager](https://knowledge.profitmetrics.io/how-to-set-up-serverside-hybrid-universal-integration-through-google-tag-manager?hsLang=en)

---

### Part 1: Activate Headless Mode in Magento

1. Login to Magento
2. Click "**Stores"**  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 2](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%202.png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%202.png)
3. Click "**Configuration**"  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 3](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%203.png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%203.png)
4. Open the **"PROFITMETRICS"** dropdown in the left menu  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 5](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%205.png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%205.png)
5. Click **"ProfitMetrics Settings"**  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 6](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%206.png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%206.png)
6. Change **"Activate Headless Mode"** from "**no**" to "**yes**".  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 35](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%2035.png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%2035.png)  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 38](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%2038.png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%2038.png)
7. Click **"Save Config"  
   ![Configure ProfitMetrics Settings in Magento 2 Admin Panel - Step 21 (1)](https://knowledge.profitmetrics.io/hs-fs/hubfs/Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%2021%20(1).png?width=688&height=385&name=Configure%20ProfitMetrics%20Settings%20in%20Magento%202%20Admin%20Panel%20-%20Step%2021%20(1).png)**

**9. Part 1:  Done**✅

---

### Part 2: Install the Server-side Hybrid Universal Integration tracking script on your website in one of two ways.

1. 1. [Install the Serverside Hybrid Universal Integration script](https://knowledge.profitmetrics.io/how-to-install-the-serverside-hybrid-universal-integration-script?hsLang=en) <https://knowledge.profitmetrics.io/how-to-install-the-serverside-hybrid-universal-integration-script?hsLang=en>
     2. [Install the Serverside Hybrid Universal Integration script in Google Tag Manager](https://knowledge.profitmetrics.io/how-to-set-up-serverside-hybrid-universal-integration-through-google-tag-manager?hsLang=en)
2. **Part 2:** Done✅

- [Getting Started](https://knowledge.profitmetrics.io/getting-started?hsLang=en#main-content)

    - [Learn the Basics](https://knowledge.profitmetrics.io/getting-started?hsLang=en#learn-the-basics)
    - [Prepare for Onboarding](https://knowledge.profitmetrics.io/getting-started?hsLang=en#prepare-for-onboarding)
    - [Account Setup](https://knowledge.profitmetrics.io/getting-started?hsLang=en#account-setup)
- [E-commerce Platforms](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#main-content)

    - [Shopify](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#shopify)
    - [WooCommerce](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#woocommerce)
    - [Magento](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#magento)
    - [PrestaShop](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#prestashop)
    - [BigCommerce](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#bigcommerce)
    - [Shopware](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#shopware)
    - [DanDomain & Related](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#dandomain-related)
    - [Universal Integration (Clientside)](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#universal-integration-clientside)
    - [Universal Integration (Server-side Hybrid)](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#universal-integration-server-side-hybrid)
    - [Other Platforms](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#other-platforms)
    - [Developer Documentation](https://knowledge.profitmetrics.io/e-commerce-platforms?hsLang=en#developer-documentation)
- [Ad Channels](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#main-content)

    - [Google Ads](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#google-ads)
    - [Meta (Facebook/Instagram)](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#meta-facebook-instagram)
    - [Microsoft Bing Ads](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#microsoft-bing-ads)
    - [Google Analytics 4](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#google-analytics-4)
    - [Partner-ads](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#partner-ads)
    - [Other Channel Configuration](https://knowledge.profitmetrics.io/ad-channels?hsLang=en#other-channel-configuration)
- [Tracking & Conversion Setup](https://knowledge.profitmetrics.io/tracking-conversion-setup?hsLang=en#main-content)

    - [Overview](https://knowledge.profitmetrics.io/tracking-conversion-setup?hsLang=en#overview)
    - [Conversion Booster for Google Ads](https://knowledge.profitmetrics.io/tracking-conversion-setup?hsLang=en#conversion-booster-for-google-ads)
    - [Conversion Booster for Meta](https://knowledge.profitmetrics.io/tracking-conversion-setup?hsLang=en#conversion-booster-for-meta)
    - [Conversion Booster Custom Pixels](https://knowledge.profitmetrics.io/tracking-conversion-setup?hsLang=en#conversion-booster-custom-pixels)
    - [Enhanced Conversions](https://knowledge.profitmetrics.io/tracking-conversion-setup?hsLang=en#enhanced-conversions)
- [Shopping Booster](https://knowledge.profitmetrics.io/shopping-booster?hsLang=en#main-content)

    - [Overview & Setup](https://knowledge.profitmetrics.io/shopping-booster?hsLang=en#overview-setup)
    - [Supplemental Feeds](https://knowledge.profitmetrics.io/shopping-booster?hsLang=en#supplemental-feeds)
    - [Campaigns & Labels](https://knowledge.profitmetrics.io/shopping-booster?hsLang=en#campaigns-labels)
    - [Troubleshooting](https://knowledge.profitmetrics.io/shopping-booster?hsLang=en#troubleshooting)
- [Product Feed & Costs](https://knowledge.profitmetrics.io/product-feed-costs?hsLang=en#main-content)

    - [Product Feed](https://knowledge.profitmetrics.io/product-feed-costs?hsLang=en#product-feed)
    - [Shipping & Payment Costs](https://knowledge.profitmetrics.io/product-feed-costs?hsLang=en#shipping-payment-costs)
    - [Expenses](https://knowledge.profitmetrics.io/product-feed-costs?hsLang=en#expenses)
- [Dashboard, Orders & Reporting](https://knowledge.profitmetrics.io/dashboard-orders-reporting?hsLang=en#main-content)

    - [Dashboard & Orders](https://knowledge.profitmetrics.io/dashboard-orders-reporting?hsLang=en#dashboard-orders)
    - [Looker Studio](https://knowledge.profitmetrics.io/dashboard-orders-reporting?hsLang=en#looker-studio)
    - [Google BigQuery](https://knowledge.profitmetrics.io/dashboard-orders-reporting?hsLang=en#google-bigquery)
- [Account & Billing](https://knowledge.profitmetrics.io/account-billing?hsLang=en#main-content)

    - [Users & Access](https://knowledge.profitmetrics.io/account-billing?hsLang=en#users-access)
    - [Billing & Invoices](https://knowledge.profitmetrics.io/account-billing?hsLang=en#billing-invoices)
- [Privacy & Consent](https://knowledge.profitmetrics.io/privacy-consent?hsLang=en#main-content)

    - [GDPR](https://knowledge.profitmetrics.io/privacy-consent?hsLang=en#gdpr)
    - [Consent Management Platforms](https://knowledge.profitmetrics.io/privacy-consent?hsLang=en#consent-management-platforms)
    - [Google Consent Mode](https://knowledge.profitmetrics.io/privacy-consent?hsLang=en#google-consent-mode)
- [For Agencies](https://knowledge.profitmetrics.io/for-agencies?hsLang=en#main-content)

    - [Getting Started as an Agency](https://knowledge.profitmetrics.io/for-agencies?hsLang=en#getting-started-as-an-agency)
    - [Agency Certification](https://knowledge.profitmetrics.io/for-agencies?hsLang=en#agency-certification)
- [Shopify](https://knowledge.profitmetrics.io/shopify?hsLang=en)
- [PrestaShop](https://knowledge.profitmetrics.io/prestashop?hsLang=en)
- [Google Ads](https://knowledge.profitmetrics.io/google-ads?hsLang=en#main-content)

    - [troubleshoot](https://knowledge.profitmetrics.io/google-ads?hsLang=en#troubleshoot)
- [Meta (Facebook / Instagram)](https://knowledge.profitmetrics.io/meta-facebook-instagram?hsLang=en)
- [Uncategorized](https://knowledge.profitmetrics.io/uncategorized?hsLang=en)
- [Billing](https://knowledge.profitmetrics.io/billing?hsLang=en)
- [Google Sheets](https://knowledge.profitmetrics.io/google-sheets?hsLang=en)
- [Account](https://knowledge.profitmetrics.io/account?hsLang=en)
- [Ideal Shop](https://knowledge.profitmetrics.io/ideal-shop?hsLang=en)

[![ProfitMetrics logo black version](https://knowledge.profitmetrics.io/hs-fs/hubfs/pm_logotype_blue.png?width=193&height=28&name=pm_logotype_blue.png "ProfitMetrics logo black version")](https://profitmetrics.io)

<https://www.facebook.com/ProfitMetrics/> <https://podcasts.apple.com/> [mailto:support@profitmetrics.io](mailto:support@profitmetrics.io)

Copyright © 2026, ProfitMetrics ApS