Site Configuration Model Introduction - Bloomreach Commerce Experience Cloud - The Headless Digital Experience Platform Built for Commerce

Site Configuration Model Introduction



Understand the design concepts behind Bloomreach Headless Experience Manager's site configuration model and the different model entities and how they relate to each other.


Managing site configuration is an essential development task when integrating Bloomreach Headless Experience Manager. It involves configuring different entities that together make up the pages to be rendered by the frontend application.

Site configuration is pre-defined by developers through the Site Management API, modified by site editors through the Experience manager app, and delivered to the frontend application through the Delivery API's Pages endpoint.

This documentation explains the site configuration model's underlying design concepts and the model's entities and their relationships.

Related Documentation

Design Concepts

Hierarchical Model-View-Controller

The hierarchical model-view-controller (HMVC) design pattern is central to the site configuration model and the main end product derived from it: pages. Each page is a layout tree consisting of containers and components. Each component consists of a model (content and/or product data), a view (presentation), and a controller (logic). All three of these are managed through Bloomreach Headless Experience Manager: 

  • Model: content editing is core functionality of Bloomreach Headless Experience Manager.
  • View: presentation is supported through configurable component parameters, the Delivery API's Pages endpoint, and the frontend SDKs.
  • Controller: built-in base components provide out-of-the-box configurable backend functionality such as querying and retrieving content and/or product data.


The wiring for the HMVC pages is managed through routing configuration. Routes map requested URLs to layouts and content items, resulting in the actual page objects served through the Delivery API's Pages endpoint and rendered by the frontend application.

Entities and Relationships Overview

The following diagram depicts all the site configuration entities along with their relationships. Entities in red color denote that the entity is not, or only partially, managed via the Site Management API.

The following entities are explained in more detail on their respective documentation pages:

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?