CMS Collection

Overview

This page explains how CMS Collections can be used as a data source for Avonni components in Salesforce Experience Cloud.

When supported, a CMS Collection allows Avonni data-driven components—such as the List or Data Table—to be populated dynamically with content managed in Salesforce CMS (articles, images, documents, and other CMS items), without relying on Salesforce records or custom objects.

Because Salesforce provides multiple CMS architectures, this page also clarifies the critical distinction between Enhanced CMS and legacy (non-enhanced) CMS. Only CMS Collections created with Enhanced CMS are compatible with Avonni components that use CMS as a data source.

Understanding this distinction is essential to avoid configuration issues and to ensure that CMS-based data sources work as expected in Experience Cloud sites.


What is a CMS Collection?

A CMS Collection is a grouping of CMS content (articles, images, documents, etc.) that can be queried and displayed dynamically in an Experience Cloud site.

Avonni components that support CMS as a data source rely on Salesforce Content Services APIs, which are compatible only with Enhanced CMS.


Enhanced CMS vs Legacy CMS

Salesforce currently supports two CMS architectures that coexist in the platform:

Enhanced CMS (Supported)

Enhanced CMS is the modern CMS architecture introduced by Salesforce and is the only CMS type supported by Avonni components.

Key characteristics:

  • Created from Setup → CMS Workspaces

  • Uses Content Services APIs

  • CMS Collections have record IDs starting with 20V

  • Content is also addressable via a Content Key (starting with MC)

  • Designed for modern Experience Cloud features and headless delivery

This is the CMS model expected by Avonni components that support CMS Collections.


Legacy / Non-Enhanced CMS (Not Supported)

Legacy CMS is the older CMS system historically used by Aura-based Experience Cloud sites and managed from:

Experience Workspaces → Content Management

Key characteristics:

  • Backed by legacy CMS objects (for example ManagedContent and ManagedContentCollection)

  • Collections historically had record IDs starting with 0V5

  • Content and containers may use 0Zu record IDs

  • Not exposed through Content Services APIs

Although legacy CMS content may still appear usable in the Salesforce UI, it cannot be accessed programmatically by modern components that rely on Content Services.

As a result, legacy CMS Collections cannot be used as a data source for Avonni components.


Why legacy CMS Collections are not supported

Avonni components that support CMS Collections rely on Salesforce Content Services APIs to query and render content.

Salesforce only exposes Enhanced CMS content through these APIs.

Legacy CMS collections:

  • Are not available through Content Services

  • Do not provide Content Keys

  • Cannot be resolved by components expecting 20V or MC identifiers

This is a Salesforce platform limitation, not a configuration issue.


Aura sites

Even if your Experience Cloud site is Aura-based:

  • Enhanced CMS can still be used as a content source

  • Legacy CMS Collections created in Content Management are not compatible with Avonni CMS-based data sources

To use CMS Collections with Avonni components on Aura sites, you must create the collections in an Enhanced CMS Workspace.


How to create a compatible CMS Collection

To use a CMS Collection as a data source in Avonni components:

  1. Go to Setup → CMS Workspaces

  2. Create a new Enhanced CMS Workspace

  3. Create a Content Collection inside that workspace

  4. Publish content to the collection

  5. Use either:

    • the Content Collection ID (starts with 20V), or

    • the Content Key (MC…)

Only these identifiers are supported by Avonni components.


Summary

CMS Type
Workspace Location
ID Prefix
Supported by Avonni CMS data source

Enhanced CMS

Setup → CMS Workspaces

20V, MC

✅ Yes

Legacy CMS

Experience Workspaces → Content Management

0V5, 0Zu

❌ No

Last updated

Was this helpful?