Managing the pages in your portal

This page applies to Apigee and Apigee hybrid.

View Apigee Edge documentation.

For information about editing, previewing, and publishing portal pages, and managing the audience for the pages in your portal, see Developing portal content using the page editor.

Manage the pages in your portal, as described in the following sections.

About the reserved URL paths

The following URL paths are reserved for use by the developer portal and cannot be specified as the page path when creating pages:

• a
• accounts/create
• apis
• create
• docs
• login
• logout
• my-apps
• sites
• teams

The reserved path /create can be used as the target URL of a MenuItem or be linked to from a Page.

The /create reserved path will redirect to the accounts creation page.

Exploring the Pages page

To access the Pages page:

• Select Publish > Portals in the side navigation bar, select your portal, and click Pages on the landing page.
• When editing a portal, select Pages in the drop-down menu in the top navigation bar.

The list of pages in your portal is displayed.

Note: For a list of the default pages provided with the sample portal, see About the sample portal.

As highlighted in the previous figure, the Pages page enables you to:

• Create a page
• View page details, including name, relative path, status, visibility, and amount of time since the page was last modified
• Edit page content and details
• Manage the visibility of a page in your portal
• Delete pages in your portal
• Sort the list of pages by column (the arrow indicates the active column and direction of the sorted content)

Creating a page

Note: You can create a maximum of 1000 pages in your portal.

To create a new page:

1. Access the Pages page.
2. Click +Page.

3. In the Create a Page dialog, enter the following details:

   Field	Description	Required?
   Name	Name of the page. The page name must be unique within the portal. The name is used in the portal page header and browser tab.	Yes
   Path	User-friendly relative URL to use for the page. For best practices, see Implement search engine optimization (SEO). Use alphanumeric characters and dashes only. Spaces and special characters are not allowed. Defaults to the page name with spaces converted to dashes. Note: Avoid specifying a reserved URL path when creating a portal. For a list of reserved URL paths, see About the reserved URL paths.	Yes

4. Click Create to create the new page.

Editing the contents of a page

To edit the contents of a page:

1. Access the Pages page.
2. Click the name of the page that you want to edit.
3. Edit the contents of the page. See Developing portal content using the page editor.

Changes that you make to the page are saved automatically.

Editing the page details

To edit the details for a page, including the name, description, and relative path:

1. Access the Pages page.
2. Position the cursor over the page you want to edit and click in the actions menu.
3. Edit the page details.
4. Click Update.

Managing the visibility of a page in your portal (beta)

Note: To use the features described in this section, you must have enrolled in the beta release of the audience management feature.

To manage the visibility of a page in your portal:

1. Access the Pages page.
2. Position the cursor over the page for which you want to manage visibility and click in the actions menu. The Visibility dialog opens.

3. Select one of the following options:

   • Public (visible to anyone) to allow all users to view the page.
   • Authenticated users to allow only registered users to view the page.
   • Selected audiences to select the specific audiences that you want to be able to view the page. For information about managing the audiences defined for your portal, see Managing the audiences for your portal.
   Note: If you set the visibility to Authenticated users or Selected audiences, the page will not be indexed by search engines.

4. Click Save.

Deleting pages from your portal

Notes:

• You cannot delete the Home page. The index URL path serves as the default landing page for your portal.
• To avoid having an orphaned navigation menu or menu item with a broken link to a page that has been removed, it is recommended that you delete any relevant navigation menus or menu items items first, then delete the page.

To delete a page from your portal:

1. Access the Pages page.
2. Position the cursor over the page you want to edit and click in the actions menu.
3. Click Delete to confirm the operation.