Introduction

Custom domains can be setup for Guides for the Organisation or for individual Spaces.

You can setup Guides on the top level domain (example: company.com) or as a subdomain (example: guides.company.com).

To setup a custom domain, you will need:

  • a Teams or Ecosystem (Enterprise) plan,
  • ownership of the domain you want to use (you can purchase domains from a domain registrar like godaddy.com or rebel.com) and
  • access to your domain name's DNS (domain name system) settings.

Creating a Custom Domain For Your Organisation account

When you setup a custom domain for your account, users will be able to access all the Guides and Spaces they have access to at that unique URL. For this reason, an account can only have one custom domain. However, you can create additional custom domains for any Space.

Creating Custom Domains For Spaces

If you'd only like to publish a single Space - so users do not have the option of navigating to other Spaces they may have access to, you should publish a custom domain name for a Space.

Permissions

Spaces have the same permissions on custom domains as they do within the Guides application. So Spaces that are public will be available on the custom domain without the need for authentication (login and password). If you do not have public Spaces, or you are publishing a private Space on a custom domain, when unauthenticated users arrive on that page, they will be required to enter a user name and password to access the Space(s) they have access to.

Login vs Register

When creating a custom domain (for either your Organisation's account or its Spaces) that are not public , the login page will be the first page a user sees when visiting the new domain. By default, only people who already have access to your Organisation - that have been invited and already accepted - will be able to login. If you want to enable new people to register for your hub, you will need to change the signup mode setting for your hub to enable anyone to register:

Setup

Setting up your custom domain is simple and involves two steps:

  1. Setting your domain name in Guides.co for:
    1. An Organisation, or
    2. A Space
  2. Updating the settings in your DNS