Skip to main content


Optimizely CMS 12 – Content Delivery API Integration

He Puts The Pro In Programmer

In the Optimizely Content Management System (CMS), a headless approach is achieved using content delivery API. This handy package can get the data into JSON format using the REST API. In Single Page, Application, and content delivery, API works very well with JavaScript languages like React, Vue, and Angular.

A headless system can work with HTTP requests and be cross-platform. Optimizely content management does not provide direct headless solutions. However, the content delivery API package was used to meet this expectation.

Integrate Content Delivery API into CMS 12:

To integrate Content Delivery API, we need to install the content delivery API NuGet package. Following is the PowerShell query to install

dotnet add package EPiServer.ContentDeliveryApi.Cms

Packages Reference:


After installing the package, we need to modify the startup.cs file as:

public void ConfigureServices(IServiceCollection services)


This content delivery API follows the default CORS policy. This may cause CORS errors like the “Access-Control-Allow-Origin” CORS header is missing. To overcome this issue, we need to add CROS into the startup.cs file.

services.AddCors(opt =>
   opt.AddPolicy(name: "CorsPolicy", builder =>


Now we are ready to use content delivery API. To verify our content delivery API working properly, type the following URL into the browser (you can replace localhost with your site domain URL)


If the API works properly, we get a 200 OK status, and we get the JSON result as follows

There are some endpoints to retrieve data which are:

  1. Content by content ID: /api/episerver/v3.0/content/{ContentIdentifier}
  2. Child content: /api/episerver/v3.0/content/{ContentIdentifier}/children
  3. Ancestor content: /api/episerver/v3.0/content/{ContentIdentifier}/ancestors
  4. A list of sites in the system: /api/episerver/v3.0/site


Following is the Postman screenshot example to retrieve “About Us” content:


How does Content Delivery API work?

Below is the flow of the content delivery API.



In this way, the Headless Content Delivery API works and is implemented in Optimizely CMS 12.

Reference URL:

To create a drop-down list using Enum and database, in Optimizely 12 click here

Thoughts on “Optimizely CMS 12 – Content Delivery API Integration”

  1. Vishal Chikhalikar

    Nice Blog, Very helpful to integrate Headless Content Delivery API in Optimizely CMS 12.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Prasad Joshi

I am a technical expert who provides leadership in developing technology-enabled applications and services within the Optimizely Commerce framework and ZNode eCommerce framework.

More from this Author

Follow Us