Publishing landing page on your own domain is one of the best ways to maintain brand unity and ensure a seamless experience for your customers. Doing this means that the pages you create with Yext will live under the same domain as the rest of your website. For example, if your website domain is companyname.com, your restaurants will all live at restaurants.companyname.com.
In order to publish pages to your own domain, when you enter your desired domain in Yext, Yext will provide you with the Bridge Domain where your page is hosted. Once you obtain that Bridge Domain, you will need to add it to your DNS provider to create a connection so consumers visiting your subdomain will be served Pages that are built by Yext. This type of connection is called a CNAME.
This article will walk you through the process of creating a domain in the Yext platform, retrieving the Bridge Domain for your domain, and make sure that your subdomain is configured correctly with your web provider.
Before we start, below is a list of definitions of terms that will be used a lot throughout this article:
- DNS Provider: A company or service that manages domain name servers. This is the service you use to manage your main website e.g., GoDaddy or Namecheap.
- CNAME (Canonical Name): A CNAME record is typically used to map or point one domain or subdomain to another domain name.
- For example, in this instance, you are connecting your subdomain (e.g., yoursubdomain.yourdomain) to the Yext-powered page (e.g., yousubdomain.yourdomain.pagescdn.com.) so your DNS provider knows where to find the Yext-powered pages.
To add a Domain:
- Hover over Pages in the top navigation bar and click on the Domains sub-tab.
- Click + Add New Domain. A dialog box appears.
- Type your domain in the text box.
- Click Continue. The Bridge Domain should appear in the dialog box.
- Copy the Bridge Domain to set up a CNAME record in your DNS provider. See detailed instructions on how to add a CNAME record to different DNS providers below.
- The Bridge Domain will have the following structure: yoursubdomain.yourdomain.com.pagescdn.com.
- Note: Be sure to include the actual subdomain you’ve chosen and your domain in place of the example above, followed by the .pagescdn.com. (including the period after .com.). Some DNS providers may handle this automatically; your IT team will know how to configure the record correctly.
- Click Finish.
- Note, it can take up to 48 hours for the CNAME to propagate. Your domain’s Status will remain Pending until your domain is set up correctly with your DNS Provider.
- Once your CNAME record has fully propagated, your domain’s Status will be marked as Live in the Domains sub-tab.
- If you’ve waited 24-48 hours after setting up your subdomain with your DNS provider, and the Domain isn’t Active in Yext, reach out to Yext Support.
Additional Information on Adding a CNAME record to your DNS Provider
To create a CNAME record (General):
- Log into your domain registrar and locate the DNS or advanced DNS settings for the domain that you want to create a subdomain for.
- Create a new CNAME record.
- Enter your subdomain prefix in the Host field.
- In the Points to field, enter the Bridge Domain. This is what you copied from the Yext platform.
By adding this, you are allowing Yext to publish landing pages to that specific subdomain. For example, adding a CNAME record for the domain “yourcompany.com” with the subdomain “restaurants” will allow you to publish a landing page on restaurants.yourcompany.com.
It can take up to 48 hours for your DNS provider to set up your subdomain, so make sure you check back on the domains page for an indication that the record is fully propagated.
To create a CNAME record (GoDaddy DNS Provider):
For instructions directly from GoDaddy, see GoDaddy’s Add a CNAME record article.
- Log into your GoDaddy account at godaddy.com.
- Click on the name of the account and then on My Products or go to this link: https://account.godaddy.com/products/.
- Click on DNS next to the domain you want to add the subdomain to.
- Go to the bottom of the Records list and click on Add.
- Select CNAME for type.
- In the Host field enter your subdomain prefix you wish to publish your page to.
- For example, if your subdomain is restaurants.mycompany.com, your subdomain prefix is restaurants.
- The address will have the following structure: yoursubdomain.yourdomain.com.pagescdn.com.
- Note: Do not change the TTL field, this will already be set correctly by default.
To create a CNAME record (Network Solutions DNS Provider):
For instructions directly from Network Solutions, see Network Solutions’ CNAME Record article.
- Log into your account at www.networksolutions.com and click Manage Account.
- Click on the Edit DNS link under the My Domain Names section.
- Click the Edit Advanced DNS Records link next to the domain you want to use. This will open the DNS Manager Settings page.
- Scroll down to the section Host Aliases: CNAME Records, click the Edit CNAME Records button.
- In the 'Alias' field, type the name of your chosen subdomain.
- Select the Other Host radio box and type the CNAME record from the Yext platform.
- Click Continue. This will bring you to a confirmation screen.
- Confirm your settings and click Save Changes.