HomeGuidesAPI ReferenceGraphQL
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

DXP Requirements

This topic 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 that your development environment is compatible with the deployment process and the Azure resources.

Previous knowledge of cloud-based development, and Microsoft Azure in particular, is valuable to get 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 Installing Optimizely updates for information about upgrading Optimizely solutions.



Although we recommend running v12, it is still possible for new customers to use v11. For more information about why we recommend running v12, visit the .NET 5 Benefits Page.


Lowest version


Optimizely CMS

EPiServer.CMS.UI.Core 12.0.2, EPiServer.CMS.Core 12.0.3

Optimizely Search & Navigation

EPiServer.Find 14.0.1

Optimizely Commerce

EPiServer.Commerce 14.0.2

Optimizely Cloud CMS

EPiServer.CloudPlatform.Cms 1.0.1

Required for cms projects

Optimizely Cloud Commerce

EPiServer.CloudPlatform.Commerce 1.0.1

Required for commerce projects

Optimizely Marketing Automation

EPiServer.ConnectForMarketingAutomation 6.0.0

Optional package

Microsoft Visual Studio / Microsoft VS Code


For creating and deploying sites

Microsoft SQL Database


For creating bacpac files for database transfers

Microsoft SQL Server Management Studio

12.0.4213.0 (2014 SP1)

For creating bacpac files for database transfers

  • Only applies to new solutions onboarding DXP; does not apply to solutions 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 prior to 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 deploy through Visual Studio using the Optimizely extensions and publish profiles. You can use any deployment tool that supports Azure Resource Manager (ARM); see Deploying 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

Did this page help you?