Recommended for you: Deploy Previews
Perform QA testing and get feedback from stakeholders through Deploy Previews and related collaboration tools.
A domain name is the URL or web address where visitors find your site.
By default, any site on Netlify is accessible from its Netlify subdomain, which has the form [name-of-your-site].netlify.app
. For example, you would access a site named brave-curie-12345
at https://brave-curie-12345.netlify.app/
.
Custom domains allow you to make your sites accessible at your own domain names, such as www.yourcustomdomain.com
or docs.example.dev
. All top-level domains are supported for your custom domain.
Netlify supports custom domains for your production site, Deploy Previews, and branch deploys.
deploy-preview-#
with an automatic deploy subdomain. For example: deploy-preview-123.company.com
.branch-name.company.com
For more example custom domains, check out this chart.
yoursitename.netlify.app
or www.yourcustomdomain.com
.com
part in www.yourcustomdomain.com
.yourcustomdomain.com
part in www.yourcustomdomain.com
.www.yourcustomdomain.com
and app.yourcustomdomain.com
are subdomains of yourcustomdomain.com
.[name-of-your-site].netlify.app
given to each site.Your site deploys can have different domain patterns based on the type of site deploy.
Site deploy type | Custom domain | Use case |
---|---|---|
Production deploy | company.com | Can set a primary domain for your production site. |
Deploy Preview | deploy-preview-42.early-access.company.com | Can set a custom domain for Deploy Previews with an automatic deploy subdomain. |
Branch deploy for a branch named staging | Branch subdomain: staging.company.com Automatic deploy subdomain: staging.early-access.company.com or staging.internal-events.com | Can set a custom domain for your branch deploys with an automatic deploy subdomain or branch subdomains. |
By default, your site deploys are available at a URL using the Netlify subdomain yoursitename.netlify.app
. The Netlify subdomain URLs will always work even if you set up a custom domain for your site.
Site deploy type | Netlify subdomain | Use case |
---|---|---|
Production deploy | yoursitename.netlify.app | Typically a placeholder URL, ideal for internal development before assigning a custom domain for site visitors. |
Deploy Preview | deploy-preview-42--yoursitename.netlify.app | Unique URL for previewing and collaborating on each pull/merge request. |
Branch deploy for a branch named staging | staging--yoursitename.netlify.app Note: With a branch subdomain set up, the URL can be staging.yourcustomdomain.com . | Long-standing URL ideal for internal testing, QA teams, and ongoing development. To set up branch deploys, check out branch deploy controls. |
Atomic deploy | 1234abcd12acde000111cdef--yoursitename.netlify.app | Unique URL for a specific build that is successfully deployed. Also called deploy permalinks or just permalinks. Unlike the other site deploys, the web content at this URL never changes. A new deploy permalink is generated for each successfully deployed build of your site. |
To assign a custom domain or domain alias to a production site, go to Site settings › Domain management › Production domains.
Tip
You can change a site’s default Netlify subdomain by selecting the Options button next to the subdomain in the Production domains panel, then selecting Edit site name in the menu.
To add a custom domain, select Add a domain at the bottom of the Production domains panel, and enter your domain name. Select Verify. Your next option depends on whether the domain has been registered.
If the domain is unregistered, you are given the option to register the domain on Netlify. If you choose this option, you can follow the instructions in the UI and your domain will be automatically configured using Netlify DNS. No further configuration is necessary, but you may want to learn more about your new domain:
If the domain is registered (already has an owner), you will be asked to confirm that you are the owner of the domain. If you are not the owner, you’ll have to choose another domain. If you are the owner, select Yes, add domain to assign the custom domain to the site. The next step depends on how your domain is registered:
Visit our Forums for a list of verified Support Guides that highlight best practices for using and configuring Netlify DNS and custom domains.
Recommended for you: Deploy Previews
Perform QA testing and get feedback from stakeholders through Deploy Previews and related collaboration tools.
Recommended for you: Deploy notifications
Enable notifications for deploy events triggered by your site’s deploy activity. Use Slack, webhooks, email, your Git provider, or other integrations.
Custom domains: Assigning a root domain or a www subdomain
Manual DNS configuration for root and www custom domains
Manual DNS configuration for root and www custom domains
Manual DNS configuration for non-www custom domains
Your feedback helps us improve our docs.