Migrate to the new version of the portal

Migrate a portal based on the original version to the new version to take advantage of the latest portal features:

  • Enhancements to the following portal front-end features:
    • SmartDocs API reference documentation
    • Theme editor enhancements
    • Default portal theme and content enhancements
    • Quick start
  • Improvements to how developer accounts are managed using the developer identity service

For more information, see Build your integrated portal.

Before you migrate

Before you begin, review the following considerations:

  • A copy of your portal is made before the migration.
  • The new default theme is applied and your custom CSS styles are overwritten. You need to apply your custom CSS styles manually after the migration.
  • If the developer identity service is enabled, the new and existing portals share the same user store. Changes to the user store will impact both portals.
  • In order to support responsive menus, top-level menu items that contain child objects will no longer be active links.

Steps to migrate

To migrate to the new version of the portal:

  1. Select Publish > Portals to view the list of portals.
  2. Click Upgrade to 2.0.
  3. Edit the name of the migrated portal in the New Portal Name field.
    This field defaults to *portal-name* Migrated.
  4. Click Migrate.

The new portal is created with your migrated content.