You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs/release/notes/apigee-release-notes). info

> [!NOTE]
> **Note:** The integrated portal is available as an Apigee-managed solution for Apigee Edge for Public Cloud customers only. If you are an Apigee Edge for Private Cloud customer, refer to the customer-managed Drupal 10 portal solution.

Upgrade a [portal based on the original version](https://docs.apigee.com/api-platform/publish/portal/original-theme/overview-portal-v1) 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](https://docs.apigee.com/api-platform/publish/portal/build-integrated-portal).

## How do I know if I need to upgrade my portal?

When [viewing the list of portals](https://docs.apigee.com/api-platform/publish/portal/manage-portals#view-portals), if your portal needs to be upgraded to the new version, the following alert is displayed in the **Upgrade status** column:

![Upgrade your portal](https://docs.apigee.com/static/api-platform/images/portal-upgrade.png)

If your portal is using the new version, the following message is displayed in the **Upgrade status** column:

![No action required](https://docs.apigee.com/static/api-platform/images/portal-upgrade-complete.png)

> [!NOTE]
> **Note:** If all of your portals are using the new version, the **Upgrade status** column will not be displayed.

## 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.
- The legacy passwordless authentication via email will be replaced by portal user accounts with either [user credentials](https://docs.apigee.com/api-platform/publish/portal/portal-interact#built-in) (built-in identity provider) or [SAML](https://docs.apigee.com/api-platform/publish/portal/portal-interact#saml-auth) (beta). Existing users should be advised to recreate their accounts using the same email address so that any existing applications owned by that email address will appear in their account.

## 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 <var translate="no">portalname</var> 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.