Google is committed to advancing racial equity for Black communities. See how.

Upgrade to the new version of the portal

You're viewing Apigee Edge documentation.
View Apigee X documentation.

Upgrade 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
  • Audience and visibility controls

  • Improvements to how developer accounts are managed using the developer identity service

  • SAML integration

For more information, see Build your integrated portal.

Before you upgrade

Before you upgrade, review the following considerations:

  • A copy of your portal is made before the upgrade.
  • The new default theme is applied and your custom CSS styles are overwritten. You need to apply your custom CSS styles manually after the upgrade.
  • In order to support responsive menus, top-level menu items that contain child objects will no longer be active links.

Steps to upgrade

To upgrade to the new version of the portal:

  1. Select Publish > Portals to view the list of portals.
  2. Click Upgrade.
    The Upgrade your portal dialog displays.
  3. Click Upgrade now.

The portal is upgraded. The name of the new upgraded version defaults to portalnamev2, where portalname is the portal name converted to all lowercase and with spaces removed.

The Upgrade Status column for the original portal is changed to Deprecated to indicate that the portal has been upgraded. Position your cursor over the Deprecated status for a portal to view the name of its upgraded version.