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

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 whitelisting of IP addresses in the firewall, make sure that your firewall supports domain-based whitelisting.

## 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.

(Script tags will be stripped)

(Only applies to new solutions onboarding DXP; does not apply to solutions already on DXP.)


EPiServer.CloudPlatform.Cms causes a routing exception if any custom routes are set unless you add the following to appSettings in web.config (CMS 11): `<add key="episerver:healthcheck:maphttpattributeroutes" value="false" />`

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 apps (add-ons)


You must install [add-on](🔗) modules to the integration environment through Visual Studio to work with the DXP deployment process. Do not change the default configuration that disables users from installing to production.

  • [Google Analytics for Optimizely](🔗)

  • [Optimizely Languages](🔗)

  • [Optimizely Live Monitor](🔗)

  • [Optimizely Publish from Office](🔗)

  • [Optimizely Social Reach](🔗)

  • [Optimizely Spellchecker for TinyMCE](🔗)

  • [Optimizely Self-Optimizing Block](🔗)

  • [Optimizely Visitor Groups Criteria Pack](🔗)

  • [Translations.com](🔗)

  • [SEO Manager](🔗)

  • [Optimizely Digital Experience Hub](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-Acoustic (Silverpop)](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-Delivra](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-Eloqua](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-HubSpot](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-Marketo](🔗)

    • [Optimizely Digital Experience Hub for CRM-Microsoft Dynamics CRM](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-Pardot](🔗)

    • [Optimizely Digital Experience Hub for CRM-Salesforce](🔗)

    • [Optimizely Digital Experience Hub for Marketing Automation-Salesforce Marketing Cloud (ExactTarget)](🔗)

### Unsupported apps (add-ons)

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

  • Optimizely CMO

  • Optimizely Mail

  • Optimizely Relate

  • Optimizely Search