Architecture Overview
Kibo CMS operates as a composable layer that sits alongside the rest of Kibo’s commerce services. Content is authored and managed through the Kibo CMS admin interface, then delivered to storefronts and other consumers via a GraphQL API. The platform consists of three main functional areas:- Website Builder — A visual page editor for building and publishing web pages, including dynamic pages that pull live data from the Kibo Commerce catalog.
- Headless CMS — A structured content management system with a GraphQL API, content models, and revision history for managing arbitrary content types.
- File Manager — Centralized asset storage and management for images and other media used across pages and content entries.
Multi-Tenant Model
Kibo CMS uses an isolated multi-tenant architecture. Each company or brand is provisioned as its own tenant with a dedicated content space — content, users, roles, and configuration in one tenant are completely isolated from all others. To provision a new Kibo CMS tenant, raise a support request with Kibo Support. Support will establish the isolated workspace and install default configuration for your company.Kibo Commerce Integration
The Kibo CMS Website Builder connects directly to the Kibo Commerce product catalog. This allows content authors to create dynamic pages that render live product and category data rather than static copies.Dynamic Page Types
Two dynamic page types are available in the Website Builder:| Page Type | Label | Commerce Data |
|---|---|---|
kiboProductPage | Kibo Product Page | Renders product information by productCode |
kiboCategoryPage | Kibo Category Page | Renders category browsing by categoryCode |
Product Data Mapping
When a product is resolved from the Kibo Commerce catalog, the following fields are used by the Website Builder:| Kibo Commerce Field | Website Builder Mapping |
|---|---|
productCode | id, handle |
content.productName | title |
content.productImages[0].imageUrl | image.src |
Category Data Mapping
When a category is resolved from the Kibo Commerce catalog, the following fields are used:| Kibo Commerce Field | Website Builder Mapping |
|---|---|
categoryCode | id |
content.name | title |
content.slug | handle |
content.categoryImages[0].imageUrl | image.src |
Content Delivery
Published content from both the Website Builder and Headless CMS is delivered through a GraphQL API. Consumer applications — storefronts, mobile apps, or third-party systems — query this API to retrieve content. Key characteristics of the content delivery API:- All content is returned as structured JSON via GraphQL queries.
- Published and draft content states are tracked separately; consumers typically query published content only.
- The API supports filtering, sorting, and pagination for content entry lists.
- Responses include revision metadata, enabling consumers to implement caching strategies tied to content version.
Getting Started
| Resource | Description |
|---|---|
| Kibo CMS Overview | Introduction to the main capabilities of Kibo CMS |
| Kibo CMS Glossary | Definitions for content models, fields, entries, and other core concepts |
| Create a Content Model | Step-by-step guide to defining your first content model in the Headless CMS |

