Skip to content

Add a domain

Custom domains for sites hosted on the VIP Platform are added in the VIP Dashboard, and can be added before their DNS is pointed to VIP.

Prerequisites

To map a domain to an application’s environment, a user must have at minimum an Org member role or an App write role for that application.

  • The www version of a domain is actually a subdomain of the non-www (root) version of a domain. The DNS for both versions of the domain must be updated to point to VIP.
  • When a domain is added to the VIP Dashboard, by default the www or non-www variant of the domain is also included and associated with the environment.
  • When a www variant of a subdomain or a sub-subdomain is added to the VIP Dashboard (e.g., www.admin.example.comwww.sub.admin.example.com) its non-www variant is also included.
  • When a non-www variant of a subdomain or a sub-subdomain (with a TLD matching .com.net, or .org)  is added to the VIP Dashboard (e.g., admin.example.comsub.admin.example.com) its www variant is not added automatically. The www variant must be added separately.
  • The fully qualified domain name (FQDN) for a site on the VIP Platform can be either the www or non-www variant of the domain. Whichever variant of the domain is added to the VIP Dashboard will be considered the FQDN.
  • Redirects between the www or non-www variants of a domain are automatic on single sites but must be configured for multisites.
  • A site will not be publicly accessible at the new domain until the site is launched and DNS for the domain has been pointed to VIP.

Add a domain

Domains have specific application and environment associations.

  1. Navigate to the VIP Dashboard for the application that the domain should be associated with.
  2. Select the environment that the added domain will point to (e.g., Production, Develop) from the dropdown located at the upper left of the dashboard.
  3. Select “Domains & Certs” from the sidebar navigation at the left of the screen.
  4. Select the “Add Domain” button located in the upper right.
  5. Enter the domain into the available field and select “Add“.
  6. Within 10 minutes the added domain will appear in the list of domains associated with the environment.
Screenshot of the Domains and Certificates panel of the VIP Dashboard

Remove a domain

Domains have specific environment associations. Begin by selecting the correct environment (e.g., Production, Develop) from the dropdown located at the upper left of the VIP Dashboard application view.

  1. Navigate to the VIP Dashboard.
  2. Select the environment that the domain points to (e.g., Production, Develop) from the dropdown located at the upper left of the dashboard.
  3. Select “Domains & Certs” from the sidebar navigation at the left of the screen.
  4. Select the “•••” button located to the right of the domain.
  5. Select “Remove” from the overflow menu.
  6. Select the “Confirm” button to complete the removal.

Last updated: December 22, 2023

Relevant to

  • Node.js
  • WordPress