owaiskhan
Jun 16, 2026
visibility 470
star star star star star
(0 votes)

Integrating Optimizely CMP Assets into an Existing Document Listing Page

Integrating Optimizely CMP Assets into an Existing Document Listing Page

In some projects, there may be a requirement to retrieve assets from Optimizely CMP and display them alongside existing content on the website.

Scenario

Consider an existing Document Listing page where all documents are managed in Optimizely CMS and indexed through Episerver Search & Navigation (Find). A new requirement is introduced to display assets stored in Optimizely CMP within the same listing page, together with CMS documents.

Available Options for Retrieving CMP Assets

1. Optimizely CMP Graph API

https://cg.optimizely.com/app/graphiql?auth={singlekey}

2. Optimizely CMP Open REST API

https://www.postman.com/optimizely/optimizely-s-postman-collection-s/collection/9vnewz3/optimizely-cmp-open-rest-api?sideView=agentMode

https://developers.welcomesoftware.com/openapi.html

Proposed Solution

Implement a dedicated CMP API Service responsible for retrieving assets from Optimizely CMP. The service should:

  • Fetch asset data using either the CMP Graph API or Open REST API.
  • Map CMP asset data to a common document model already used by the existing Document Listing page.
  • Merge CMP assets and Optimizely CMS documents into a unified collection.
  • Apply existing filtering, sorting, and pagination logic consistently across both content sources.
  • Render the combined results on the same listing page without requiring significant changes to the front-end implementation.

This approach allows the existing listing page to support content from multiple sources while maintaining a consistent user experience and minimizing changes to the current architecture.

Jun 16, 2026

Comments

error Please login to comment.
Latest blogs
Composition Over Inheritance: Why Your Content Contract Is Not a Base Class

Inside the structural conformance pattern in SaaS CMS — from server-side inheritance to pipeline governance. A contract in Optimizely SaaS CMS is...

Vipin Banka | Sep 19, 2026

Optimizely Opti ID Integration: Why the API Key Was Missing from the DXP Management Portal

While working on an Optimizely CMS 12 Opti ID integration recently, we ran into an issue that initially appeared to be related to SSO authenticatio...

Madhu | Sep 18, 2026 |

Extending a Contract: What You Can Override

Contracts share fields across content types — but not every field setting can be overridden. Push the same contract onto several components, and CM...

Chirag Khanna | Sep 18, 2026 |

Building a Blazor Server UI Inside the Optimizely CMS 13 Admin Shell

What I learned shipping a Blazor Server UI inside Optimizely CMS 13 — Razor components in a NuGet package, the Blazor hub next to MapContent(),...

Stanisław Szołkowski | Sep 17, 2026 |