---
title: "Using CNAME with your site collection"
date: "2024-02-14T06:18:38+00:00"
summary: "Learn how to use CNAME forwarding to connect your custom domain to a Site Factory site collection. Discover step-by-step instructions for setting up DNS records and adding domains to your site for improved availability and user access."
image:
type: "page"
url: "/site-factory/using-cname-your-site-collection"
id: "9911a877-64ce-49f7-9679-8fdc624eb595"
---

**CNAME forwarding** is the preferred method for connecting a [domain name you have purchased](/site-factory/manage/domains) to a Site Factory [site collection](/site-factory/manage/website/site-coll).

A CNAME record redirects website visitors from the domain name they entered in their browsers to another domain name—in this case, your Site Factory site collection. Using CNAME to point to a site collection location instead of an IP address also allows Site Factory to better guarantee high availability.

Note

[Forwarding your domain name directly to a single IP address using an A Record](/site-factory/manage/domains/point/arecord-coll) is possible, but can compromise your Site Factory site collection’s availability to visitors.

To use a CNAME record for your domain name:

1.  Contact your domain name registrar and learn how to manage your domain name. In most cases, you can access DNS controls by logging in to your domain name registrar’s website. Your domain name registrar is your best resource for information about managing your domain name on their website.
    
2.  Using your domain name registrar’s instructions, create the `www` subdomain of your domain, and any other required subdomains. Subdomains are addresses based on your second-level domain name, but prefixed with a descriptor, such as `www` or `blog`. For example, if your domain name is `example.com`, you would create `www.example.com` along with any other required subdomains.
    
3.  Create a CNAME entry or record to point the complete `www` subdomain (and, separately, any other subdomains) to your Site Factory site collection.
    
    Note
    
    *   Not all domain registrars offer DNS services, and not all DNS services allow CNAME record changes. In these cases, you can [point your domain name to your Site Factory site collection using an A record](/site-factory/manage/domains/point/arecord-coll).
        
    *   It can take up to 48 hours for forwarding and CNAME entries to propagate across the Internet.
        
    

After you create a CNAME record for your custom domain, you must add the domain to your Site Factory site collection.

Adding your domain
------------------

To add the `www` subdomain (and any other subdomains you created for your domain name) to your Site Factory site collection:

1.  [Sign in](/site-factory/login) to the Site Factory Management Console on your production environment, find the site collection to which you want to add a custom domain name, and then open its actions menu.
    
    ![Selecting Manage Domains from the actions menu](https://acquia.widen.net/content/mj1aecus99/jpeg/site-factory_managing-domains-1.jpeg?position=c&color=ffffffff&quality=80&u=u1mnox)
    
    Important
    
    Domains added to non-production environments are removed when you [restage a Factory to the non-production environment](/site-factory/workflow/staging).
    
2.  Click **Manage Domains**.
    
3.  In the **Associate a domain** section, enter your domain name (such as `www.example.com`).
    
    Important
    
    Some domain name registrars list domain names in all capital letters in their web interfaces. Be sure to enter your domain name into the **Add a domain** field using **lowercase letters only**. For example, enter `www.example.com` instead of `WWW.EXAMPLE.COM`.
    
4.  Click **Associate domain**.
    

Note

If your domain’s CNAME record hasn’t been created properly or if it has not yet fully propagated, you can’t add it to your Site Factory website. Wait some time and try again.

Your `www` subdomain directs visitors to your Site Factory website and all its URLs will be listed.

Some users won’t use the `www` when visiting your website, so forward your domain name (such as `example.com`) to the `www` subdomain (`www.example.com`) based on your domain name registrar’s instructions.

Your website’s visitors can then find your website with or without the `www`.

Troubleshooting domain issues
-----------------------------

You can add domain names to only one environment. Attempting to add a domain to a second environment causes Site Factory to both fail with a logged warning message, and send an email like the following example to the user who attempted to add the domain:

    The following domains could not be added to the [sitename] site:
    [domain list]. If you want to add this domain to the [sitename]
    site, remove it from the site that has claimed the domain and then add it
    again at [factory URL].

To resolve the problem, remove the domain name from _both_ environments and then add the domain name to the single, appropriate environment.

### [Continue to the next step >](/site-factory/manage/domains/verify)