Merge pull request #234936 from dlepow/docs-editor/configure-custom-domain-1681851856

Update configure-custom-domain.md

Author: prmerger-automator[bot]

articles/api-management/configure-custom-domain.md

@@ -48,11 +48,12 @@ There are several API Management endpoints to which you can assign a custom doma
 | **SCM** | Default is: `<apim-service-name>.scm.azure-api.net` |
 
 ### Considerations
+
 * You can update any of the endpoints supported in your service tier. Typically, customers update **Gateway** (this URL is used to call the APIs exposed through API Management) and **Developer portal** (the developer portal URL).
 * The default **Gateway** endpoint also is available after you configure a custom Gateway domain name. For other API Management endpoints (such as **Developer portal**) that you configure with a custom domain name, the default endpoint is no longer available.
 * Only API Management instance owners can use **Management** and **SCM** endpoints internally. These endpoints are less frequently assigned a custom domain name.
 * The **Premium** and **Developer** tiers support setting multiple hostnames for the **Gateway** endpoint.
-* Wildcard domain names, like `*.contoso.com`, are supported in all tiers except the Consumption tier.
+* Wildcard domain names, like `*.contoso.com`, are supported in all tiers except the Consumption tier. A specific subdomain certificate (for example, api.contoso.com) would take precedence over a wildcard certificate (*.contoso.com) for requests to api.contoso.com.
 
 ## Domain certificate options
 
@@ -103,13 +104,14 @@ API Management offers a free, managed TLS certificate for your domain, if you do
 * Currently available only in the Azure cloud
 * Does not support root domain names (for example, `contoso.com`). Requires a fully qualified name such as `api.contoso.com`.
 * Can only be configured when updating an existing API Management instance, not when creating an instance
----
 
+---
 ## Set a custom domain name - portal
 
 Choose the steps according to the [domain certificate](#domain-certificate-options) you want to use.
 
 # [Custom](#tab/custom)
+
 1. Navigate to your API Management instance in the [Azure portal](https://portal.azure.com/).
 1. In the left navigation, select **Custom domains**.
 1. Select **+Add**, or select an existing [endpoint](#endpoints-for-custom-domains) that you want to update.
@@ -155,8 +157,7 @@ Choose the steps according to the [domain certificate](#domain-certificate-optio
     :::image type="content" source="media/configure-custom-domain/gateway-domain-free-certifcate.png" alt-text="Configure gateway domain with free certificate":::
 1. Select **Add**, or select **Update** for an existing endpoint.
 1. Select **Save**.
----
-    
+
 > [!NOTE]
 > The process of assigning the certificate may take 15 minutes or more depending on size of deployment. Developer tier has downtime, while Basic and higher tiers do not.
 
@@ -191,3 +192,4 @@ You can also get a domain ownership identifier by calling the [Get Domain Owners
 ## Next steps
 
 [Upgrade and scale your service](upgrade-and-scale.md)
+