Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

HomeDev GuideRecipesAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Upgrade CMS 12 to CMS 13 (Pre-release)

Walk through migrating a CMS 12 Alloy starter site to CMS 13 and understand the considerations when migrating from CMS 12 to CMS 13.

Step-by-step upgrade

Follow the blog post to step through migrating a CMS 12 Alloy starter site to CMS 13.

Upgrade considerations

As CMS 13 changes the foundation of content delivery, you should consider the following when doing an upgrade.

Implement Opti ID

Opti ID is the single sign-on (SSO) solution for Optimizely products that lets you access all available Optimizely products with a single login point. Opti ID enables CMS 13 customers to use Optimizely Opal, an agent orchestration platform that helps you work smarter across Optimizely One. Opti ID manages only users of CMS 13 and does not manage visitor logins for your frontend site.

Opti ID provides multiple options for managing user identity and permissions so that you can choose the best fit for your organization. Explore available Opti ID configuration options, including local login, SSO, and SSO with SCIM. Familiarize yourself with the Opti ID Admin Center for user, role, and group management.

Implement Optimizely Graph

Graph can be enabled for testing purposes on an existing DXP project. This provides access to a Graph instance that can be used for development and validation, but it is not intended for live/production traffic, There is no trial end date, and it is free to use at this stage.

To enable Graph today:

  1. You need to have a DXP project.
  2. In the PaaS portal, go to your project.
  3. Go to the API tab.
  4. From there, add a Graph instance using the existing self-service flow.

Once self-service support for creating a full (non-trial) Graph index is available, this flow will be extended accordingly.

📘

Note

If you do not have a Optimizely DXP subscription and still want to use CMS 13 and Graph, Contact Optimizely Support for further instructions.

Once you have a Graph instance enabled, you can implement Optimizely Graph.

Migrate from Search & Navigation

CMS 13 and future releases will no longer support Search & Navigation implementations. You should implement search with Graph or a third-party search provider.