refactored to create separate configuration article

Author: gitName

articles/api-center/TOC.yml

@@ -74,7 +74,9 @@
   items:
   - name: Enable API Center portal
     href: set-up-api-center-portal.md
-  - name: Enable API Center portal - VS Code extension
+  - name: Customize API Center portal
+    href: customize-api-center-portal.md
+  - name: Enable API Center portal view - VS Code extension
     href: enable-api-center-portal-vs-code-extension.md
   - name: Self-host Azure API Center portal
     href: self-host-api-center-portal.md

articles/api-center/customize-api-center-portal.md

@@ -0,0 +1,86 @@
+---
+title: Customize the API Center Portal
+description: Learn about settings you can customize in your Azure API Center portal.
+author: dlepow
+ms.service: azure-api-center
+ms.topic: how-to
+ms.date: 08/07/2025
+ms.update-cycle: 180-days
+ms.author: danlep 
+ms.custom: 
+ms.collection: ce-skilling-ai-copilot
+# Customer intent: As an API program manager, I want to customize the Azure-managed portal for developers and other API stakeholders in my organization.
+---
+
+# Customize your API Center portal
+
+This article explains settings that you can customize in the API Center portal (preview). The API Center portal is an Azure-managed website that developers and other stakeholders in your organization use to discover the APIs in your [API center](overview.md). 
+
+To set up the API Center portal for initial use and sign-in, see [Set up the API Center portal](set-up-api-center-portal.md).
+
+> [!NOTE]
+> The API Center portal is currently in preview.
+
+## Portal settings page
+
+Configure API Center portal settings in the Azure portal. To access the settings page:
+
+1. Navigate to your API center in the Azure portal.
+1. Under **API Center portal**, select **Settings**. 
+1. Click on the tabs to view and customize the settings.
+1. Select **Save + publish** to apply your changes.
+
+:::image type="content" source="media/customize-api-center-portal/configure-portal-settings.png" alt-text="Screenshot of API Center portal settings in the Azure portal." lightbox="media/customize-api-center-portal/configure-portal-settings.png":::
+
+> [!IMPORTANT]
+> Select **Save + publish** each time that you make changes to the settings. Until you publish, your changes aren't visible in the API Center portal.
+
+## Site profile
+
+On the **Site profile** tab, optionally provide a custom name that appears in the top bar of the published portal.
+
+:::image type="content" source="media/customize-api-center-portal/custom-name.png" alt-text="Screenshot of custom name in API Center portal.":::
+
+## API visibility
+
+On the **API visibility** tab, control which APIs are discoverable (visible) to API Center portal users. Visibility settings apply to all users of the API Center portal.
+
+The API Center portal uses the [Azure API Center data plane API](/rest/api/dataplane/apicenter/operation-groups) to retrieve and display APIs in your API center, and by default shows all APIs for signed-in users with Azure RBAC permissions. 
+
+To make only specific APIs visible, add filter conditions for APIs based on built-in properties. For instance, choose to display APIs only of certain types (like REST or GraphQL) or based on certain specification formats (such as OpenAPI).
+
+:::image type="content" source="media/customize-api-center-portal/add-visibility-condition.png" alt-text="Screenshot of adding API visibility conditions in the portal.":::
+
+## Anonymous access
+
+On the **API visibility** tab, optionally enable anonymous read access to the [Azure API Center data plane API](/rest/api/dataplane/apicenter/operation-groups), which allows unauthenticated users to discover the API inventory by direct API calls. For example, enable this setting to make APIs discoverable to unauthenticated users when you [self-host](self-host-api-center-portal.md) the API Center portal.
+
+> [!CAUTION]
+> When enabling anonymous access, take care not to expose sensitive information in API definitions or settings.
+
+## Semantic search
+
+If enabled on the **Semantic search** tab, the API Center portal supplements basic name-based API search with AI-assisted *semantic search* built on API names, descriptions, and optionally custom metadata. Semantic search is available in the **Standard** plan only.
+
+Users can search for APIs using natural language queries, making it easier to find APIs based on their intent. For example, if a developer searches for "I need an API for inventory management," the portal can suggest relevant APIs, even if the API names or descriptions don't include those exact words.
+
+> [!TIP]
+> When using the **Free** plan of Azure API Center, you can [upgrade easily](frequently-asked-questions.yml#how-do-i-upgrade-my-api-center-from-the-free-plan-to-the-standard-plan) to the **Standard** plan to enable full service features including semantic search in the API Center portal.
+
+To use AI-assisted search when signed in to the API Center portal, click in the search box, select **Search with AI**, and enter a query.
+
+:::image type="content" source="media/customize-api-center-portal/semantic-search.png" alt-text="Screenshot of semantic search results in API Center portal.":::
+
+## Custom metadata
+
+On the **Metadata** tab, optionally select [custom metadata](metadata.md) properties that you want to expose in API details and semantic search.
+
+## Enable access to test console for APIs
+
+You can configure user settings to granularly authorize access to APIs and their specific versions in your API center. For example, configure certain API versions to use API keys for authentication, and create an access policy that permits only specific users to authenticate using those keys. 
+
+Access policies also apply to the "Try this API" capability for APIs in the API Center portal, ensuring that only portal users with the appropriate access policy can use the test console for those API versions. [Learn more about authorizing access to APIs](authorize-api-access.md)
+
+## Related content
+
+* [Enable and view Azure API Center portal in Visual Studio Code](enable-api-center-portal-vs-code-extension.md)

articles/api-center/media/set-up-api-center-portal/add-visibility-condition.png renamed to articles/api-center/media/customize-api-center-portal/add-visibility-condition.png

@@ -14,7 +14,7 @@ ms.collection: ce-skilling-ai-copilot
 
 # Set up your API Center portal
 
-This article shows you how to set up the *API Center portal* (preview), an Azure-managed website that developers and other stakeholders in your organization can use to discover the APIs in your [API center](overview.md). Signed-in users can browse and filter APIs and view API details such as API definitions and documentation. User access to API information is based on Microsoft Entra ID and Azure role-based access control.
+This article shows you how to set up the *API Center portal* (preview), an Azure-managed website that developers and other stakeholders in your organization use to discover the APIs in your [API center](overview.md). Signed-in users can browse and filter APIs and view API details such as API definitions and documentation. User access to API information is based on Microsoft Entra ID and Azure role-based access control.
 
 :::image type="content" source="media/self-host-api-center-portal/api-center-portal-signed-in.png" alt-text="Screenshot of the API Center portal after user sign-in.":::
 
@@ -31,22 +31,20 @@ This article shows you how to set up the *API Center portal* (preview), an Azure
 
 [!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
 
-## Customize and publish the API Center portal
+## Configure and publish the API Center portal
 
-After creating the API Center portal app registration, you can customize settings for your API Center portal. Complete the following steps in the Azure portal.
+After creating the API Center portal app registration, you can configure settings for your API Center portal. Complete the following steps in the Azure portal.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
 1. In the left menu, under **API Center portal**, select **Settings**.
 
     :::image type="content" source="media/set-up-api-center-portal/configure-portal-settings.png" alt-text="Screenshot of API Center portal settings in the Azure portal." lightbox="media/set-up-api-center-portal/configure-portal-settings.png":::
+
 1. If you set up an app registration manually, on the **Identity provider** tab, select **Start set up**. If you used the quick setup, this step is already complete, and you can continue to settings on other tabs.
     1. On the **Manual** tab, in **Client ID**, enter the **Application (client) ID** from the app registration you created in the previous section.
     1. Confirm that the **Redirect URI** is the value you configured in the app registration. 
     1. Select **Save + publish**.
-1. On the **Site profile** tab, enter a website name that you want to appear in the top bar of the API Center portal. Select **Save + publish**.
-1. On the **API visibility** tab, optionally configure filters for APIs that you want to make discoverable in the portal. Select **Save + publish**. [Learn more about API visibility](#api-visibility)
-1. On the **Semantic search** tab. optionally enable [semantic search](#search-with-ai) to enhance API discovery in the portal. Select **Save + publish**.
-1. On the **Metadata** tab, optionally select [custom metadata](metadata.md) properties that you want to expose in API details and semantic search. Select **Save**.
+1. On the remaining tabs, optionally customize the settings for your API Center portal. For information on the settings, see Customize your API Center portal](customize-api-center-portal.md). 
 1. Select **Save + publish**.
 
 ## Access the portal
@@ -59,28 +57,10 @@ After publishing, you can now access the API Center portal in your browser.
 
 By default, the portal home page is reachable publicly but requires sign-in to access APIs. See [Enable sign-in to portal by Microsoft Entra users and groups](#enable-sign-in-to-portal-by-microsoft-entra-users-and-groups) for details on how to configure user access to the portal.
 
-## API visibility
-
-API visibility settings control which APIs are discoverable (visible) to API Center portal users. The API Center portal uses the [Azure API Center data plane API](/rest/api/dataplane/apicenter/operation-groups) to retrieve and display APIs in your API center, and by default shows all APIs for signed-in users with Azure RBAC permissions. Visibility settings apply to all users of the API Center portal.
-
-To make only specific APIs visible, go to the **API visibility** tab in the API Center portal settings. Here, add filter conditions for APIs based on built-in properties. For instance, choose to display APIs only of certain types (like REST or GraphQL) or based on certain specification formats (such as OpenAPI).
-
-:::image type="content" source="media/set-up-api-center-portal/add-visibility-condition.png" alt-text="Screenshot of adding API visibility conditions in the portal.":::
-
-### Anonymous access
-
-Optionally enable anonymous read access to the API Center's APIs,  which allows unauthenticated users to discover the API inventory by direct calls to the API Center data plane API. For example, enable this setting to make APIs discoverable to unauthenticated users when you [self-host](self-host-api-center-portal.md) the API Center portal.
-
-> [!CAUTION]
-> When enabling anonymous access, take care not to expose sensitive information in API definitions or settings.
-
 ## Enable sign-in to portal by Microsoft Entra users and groups 
 
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
-## Enable access to test console for APIs
-
-You can configure user settings to granularly authorize access to APIs and their specific versions in your API center. For example, configure certain API versions to use API keys for authentication, and create an access policy that permits only specific users to authenticate using those keys. This policy also applies to the "Try this API" capability for APIs in the API Center portal, ensuring that only portal users with the appropriate access policy can use the test console for those API versions. [Learn more about authorizing access to APIs](authorize-api-access.md)
 
 ## API discovery and consumption in the API Center portal
 
@@ -96,20 +76,9 @@ The API Center portal supports and streamlines the work of developers who use an
 
 * **Try out APIs** that support API key authentication or OAuth 2.0 authorization
 
-## Search with AI
-
-In the Standard plan of Azure API Center, the API Center portal supplements basic name-based API search with AI-assisted *semantic search* built on API names, descriptions, and optionally custom metadata. Users can search for APIs using natural language queries, making it easier to find APIs based on their intent. For example, if a developer searches for "I need an API for inventory management," the portal can suggest relevant APIs, even if the API names or descriptions don't include those exact words.
-
-> [!TIP]
-> If you're using the Free plan of Azure API Center, you can [upgrade easily](frequently-asked-questions.yml#how-do-i-upgrade-my-api-center-from-the-free-plan-to-the-standard-plan) to the Standard plan to enable full service features including semantic search in the API Center portal.
-
-To use AI-assisted search when signed in to the API Center portal, click in the search box, select **Search with AI**, and enter a query.
-
-:::image type="content" source="media/set-up-api-center-portal/semantic-search.png" alt-text="Screenshot of semantic search results in API Center portal.":::
-
-[!INCLUDE [api-center-portal-compare-apim-dev-portal](includes/api-center-portal-compare-apim-dev-portal.md)]
 
 
 ## Related content
 
 * [Enable and view Azure API Center portal in Visual Studio Code](enable-api-center-portal-vs-code-extension.md)
+* [Customize your API Center portal](customize-api-center-portal.md)