*This page
applies to **Apigee** and **Apigee hybrid**.*


*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*
![](https://fonts.gstatic.com/s/i/googlematerialicons/help/v13/gm_grey-24dp/1x/gm_help_gm_grey_24dp.png)

<br />

Create and manage your portals, as described in the following sections.

## About the portal roles

You need one of the following roles to manage your portals. To assign roles to a user, see [Change user roles in the UI](https://docs.cloud.google.com/apigee/docs/api-platform/system-administration/manage-users.md.txt#change-user-roles-in-the-ui).

| Role | Description |
|---|---|
| Portal Administrator | Full CRUD permissions for integrated portals. **Note** : The Portal Administrator role is not currently visible in the UI. In order to assign the role to a user, use the following `gcloud` command: `gcloud projects add-iam-policy-binding <project-id> --member=user:<user-email> --role=roles/apigee.portalAdmin` |
| Organization Administrator | Super user. Has full CRUD access to resources in the organization. This is a [Apigee-specified role](https://docs.cloud.google.com/apigee/docs/api-platform/system-administration/apigee-roles.md.txt#apigee-specific-roles). |
| Read-only Organization Administrator | Has read-only access to resources in the organization. This is a [Apigee-specific role](https://docs.cloud.google.com/apigee/docs/api-platform/system-administration/apigee-roles.md.txt#apigee-specific-roles). |

## Exploring the Portals page

To access the Portals page:

In the Apigee in Cloud console, go to the **Distribution \> Portals** page.

[Go to Portals](https://console.cloud.google.com/apigee/portals)

The portals page opens and lists the current portals.

The Portals page enables you to:

- [Create a portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#create-portal)
- [Build your portal and its contents](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#build)
- [View the live portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/view-live-portal.md.txt)
- [Edit portal details](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#edit-portal-details)
- [Delete a portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#delete-portal)

## Creating a portal

Create multiple portals for your organization, as required.

When you create a new portal, a set of starter pages is provided for you to use as a jump-off point. See [About the sample portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/build-integrated-portal.md.txt#sample-portal) and [Quick tips for customizing the sample portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/portal-quick-tips.md.txt).

> [!NOTE]
> **Note** : You can create a **maximum of 10 portals** in your organization.

To create a new portal:

1. [Access the Portals page](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#view-portals).
2. Click **+ Create**.
3. Enter the following information in **Create a portal**:

   | Field | Description |
   |---|---|
   | Name | Name of portal. The name can contain only letters, numbers, spaces, and the following special characters: period (.), comma (,), dash (-), or underscore (_). Must be unique across all organizations. **Note**: If you delete a portal, you cannot immediately create a portal with the same name as the deleted portal will be stored temporarily in the Trash folder. |
   | Domain | (Read only) As you enter the portal name, the default domain for the portal is displayed. For example: '*orgname-portalname* .apigee.io', where *'orgname'* is the organization name and *'portalname'* is defined using the portal name converted to all lowercase and with spaces removed. **Note** : You can customize the domain name, as described in [Customizing your domain](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/custom-domain.md.txt). |
   | Description | Description of your portal. This information is for internal use only. It will not be displayed on your live portal. |

4. Click **Create**.

<br />

## Building your portal

To build your portal and its contents:

1. [Access the Portals page](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#view-portals).
2. Click the name of the portal you want to build. The portal landing page is displayed.
3. Build the portal and its contents, as described in [steps to build your portal](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/portal-steps.md.txt).

## Editing the portal name and description

To edit portal details, including name and description:

> [!NOTE]
> **Note:** You cannot modify the default URL once the portal is created. However, you can create a [custom domain](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/custom-domain.md.txt).

1. [Access the Portals page](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#view-portals).
2. On the portal row you want to edit, click **More** \> **Edit**
3. Edit the portal name and description.
4. Click **Save**.

## Viewing the live portal

To view the live portal:

1. [Access the Portals page](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#view-portals).
2. On the portal row you want to view, click **More** \> **View live portal**.

The live portal opens in a new browser tab.

## Deleting a portal

There are times when you may need to delete a portal. For example, if you have
created a test portal to try out features in your local environment, you may
delete it after the testing phase is complete.

> [!NOTE]
> **Note:** Existing app registrations and API keys of individual developers won't be impacted when you delete a portal, but all Team related app registrations and API Keys will be deleted. See [Where app registration and API keys are stored](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/build-integrated-portal.md.txt#app-keys).

To delete a portal:

1. [Access the Portals page](https://docs.cloud.google.com/apigee/docs/api-platform/publish/portal/manage-portals.md.txt#view-portals).
2. On the portal row you want to delete, click **More** \> **Delete**
3. To confirm the delete operation:
   1. Type **DELETE** in the text field.
   2. Click **Confirm**.