Headless Bundle

Release Plan

Release	Supported OpenDXP Versions	Supported Symfony Versions	Release Date	Maintained	Branch
1.x	`^1.0`	`^7.4`	2025	Feature Branch	1.x

Installation

"require": {
    "open-dxp/headless-bundle": "^1.2",
}

Add Bundle to bundles.php:

return [
    # add to bottom
    OpenDxp\Bundle\HeadlessBundle\HeadlessBundle::class => ['all' => true],
];

Add required configuration:

opendxp_headless:
    opensearch:
        hosts:
          - localhost:9200 # replace with your opensearch 
        credentials: []

Execute: $ bin/console doctrine:migrations:migrate --prefix 'OpenDxp\Bundle\HeadlessBundle\Migrations'

Dependencies

nelmio/api-doc-bundle
lexik/jwt-authentication-bundle
gesdinet/jwt-refresh-token-bundle
w3r-one/json-schema-bundle

Supported Bundles (but not required)

open-dxp/seo-bundle (Highly Recommended)
open-dxp/i18n-bundle (Highly Recommended)
open-dxp/dynamic-search-bundle (Recommended)
- open-dxp/dynamic-search-data-provider-trinity-bundle
- open-dxp/dynamic-search-index-provider-opensearch-bundle
open-dxp/formbuilder-bundle

Using OpenDxp in hybrid mode

If you want to use this bundle with a default (classic) OpenDxp installation, please note the following limitations:

The headless-toolbox bundle is not supported
If you're using formbuilder-bundle, ensure the brick is re-enabled

[!IMPORTANT] Before starting with implementation, read the Concepts section carefully. It explains how site-based host configuration works, including General Domain resolution, per-site Asset Base URI, and Flush Frontend Cache setup.

Next Steps

Changelog

Before updating, please check the changelog!

License

For licensing details please visit LICENSE.md

Release Plan​

Installation​

Dependencies​

Supported Bundles (but not required)​

Using OpenDxp in hybrid mode​

Next Steps​

Changelog​

License​