cancel
Showing results for 
Search instead for 
Did you mean: 

Need to edit the Microsoft docs content about adding a custom domain name

The Microsoft docs regarding the Power Apps portal is difficult to understand.
We would like Microsoft to correct some of the wording in the following Microsoft docs based on actual behavior.


Title : Add a custom domain name
URL : https://docs.microsoft.com/en-us/powerapps/maker/portals/admin/add-custom-domain

==========

5. On the Choose a host name page, select one of the following options:

Add a new host name: Select this option to create a new custom domain. Enter the domain name you want in the Domain Name field.

==========

Based on this MS docs, we added a custom domain to the Power Apps Portal.
However, we found that actually adding a custom domain involves entering a predefined CNAME in the Domain Name field.
We followed the steps below to actually add the custom domain.


1. The acquired domain name is [contoso123.net].
2. The defined CNAME is [www.contoso123.net].
3. In this case, enter [www.contoso123.net] in the Domain Name field.


We couldn't figure out to enter a CNAME for the Domain Name Field because the MS docs is represented as "Enter the domain name you want in the Domain Name field."
If you enter a domain name instead of a CNAME in the Domain Name Field based on the MS docs representation, you will not be able to add the domain.
We ran into this issue and was not able to quickly implement adding a custom domain.

We feel that this confusion would not have occurred if Microsoft docs had been worded as follows.

==========

5. On the Choose a host name page, select one of the following options:

Add a new host name: Select this option to create a new custom domain. Enter the CNAME you want in the Domain Name field.

==========

Status: Started
Comments
chass
Administrator
Status changed to: Under Review

passed this along to the team!

Thanks for the heads up!

 

chass
Administrator
Status changed to: Started