HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

DXP requirements

Describes the requirements for cloud-compatible software, tools and services used when working with Optimizely Digital Experience Platform (DXP).

This information is useful to ensure your development environment is compatible with the deployment process and the Azure resources.

Previous knowledge of cloud-based development, particularly Microsoft Azure, is valuable for getting the most out of DXP. See Microsoft Azure to learn more.



  • You can run only one Web Application (ASP.NET Web Application project) in your DXP solution. However, you can have unlimited number of sites in that application.
  • To ensure maximum availability and scaling flexibility, Optimizely Search & Navigation (formerly Find) uses dynamic IP ranges. For example, if you require approval lists for IP addresses in the firewall, make sure that your firewall supports domain-based approval lists.

Required software versions

The following overview shows the minimum required versions for Optimizely products and modules, and tools and services for deploying to the integration environment. See Install Optimizely updates (CMS 11 and Customized Commerce 13) for information about upgrading Optimizely solutions.



Although we recommend running CMS 12, you can still use CMS 11. For more information about why you should run CMS 12, see .NET 5 Benefits Page.

Software or serviceLowest versionComment
Optimizely CMSEPiServer.CMS.UI.Core 12.0.2, EPiServer.CMS.Core 12.0.3*
Optimizely Search & NavigationEPiServer.Find 14.0.1*
Optimizely Customized CommerceEPiServer.Commerce 1.1.1",*
Optimizely Cloud CMSEPiServer.CloudPlatform.Cms 1.0.1Required for cms projects
Optimizely Cloud Customized CommerceEPiServer.CloudPlatform.Commerce 1.0.1Required for commerce projects
Optimizely Marketing AutomationEPiServer.ConnectForMarketingAutomation 6.0.0Optional package
Microsoft Visual Studio or Microsoft VS Code2019For creating and deploying sites
Microsoft SQL Database16For creating bacpac files for database transfers
Microsoft SQL Server Management Studio16.x (2022)For creating bacpac files for database transfers
  • This only applies to new solutions onboarding DXP, not to those already on DXP.

The following features are not supported within Optimizely DXP:

  • Optimizely Mirroring
  • Windows Workflow Foundation (WF)
  • Optimizely Search (default search; uninstall the NuGet package to remove from your solution before deployment. Optimizely Search & Navigation is included.)
  • Solr Search Provider (use Optimizely Search & Navigation)

Deployment tools

You can deploy using deployment tools for a version-controlled team development environment or through Visual Studio using the Optimizely extensions and publish profiles. You can use any deployment tool that supports Azure Resource Manager (ARM); see Deploy code changes.

Supported add-ons

Unsupported add-ons

The following add-ons are not supported in Optimizely DXP.

  • Optimizely CMO
  • Optimizely Mail
  • Optimizely Relate
  • Optimizely Search