Custom Domain: Set up Your Hub on a Subdomain

Follow

Learn how to set up a custom domain to host your Hub on a subdomain of your website (like resources.mycompany.com).


 

Before You Begin

  • To add a custom domain to your Hub, you need to be an Account Administrator.
  • In this article, we'll assume that you already know what a custom domain is and have decided on the subdomain option. If you're not sure what a custom domain is and why you'd want to use it, read this article first.
  • The setup process outlined in this article involves making some changes to your website hosting configuration, so you will likely have to work with your IT or website team to complete the those steps.

 

About Setting Up a Hub on a Subdomain

In this article, we will look at the setup process for a custom domain if you have chosen to use the subdomain option. The purpose of setting up a custom domain is to make your Uberflip Hub look like it is part of your website, even though it's being hosted on Uberflip's servers. With a subdomain, this means making your Hub accessible under a URL like resources.mycompany.com, i.e. a subdomain of your website's main domain.

To do this, you'll need to set up the subdomain to point at your Hub by creating a CNAME record with your web hosting provider. A CNAME record is essentially an alias: it tells a browser "if a user asks for URL A, tell them that they're looking at URL A, but actually show them content from URL B instead." In this case, URL A is your subdomain, and URL B points to your Hub on Uberflip's servers.

Here's a breakdown of how this process works:

  • Your Hub is hosted on Uberflip's servers at read.uberflip.com. This is the domain where we host all Hubs.
  • To get to your Hub, you want your users to visit a URL that's part of your website. This will be a subdomain of your website, in the form of [something].mycompany.com.
  • First, you'll create the subdomain you want to use. Let's say you choose resources.mycompany.com.
  • Next, you'll set up a CNAME record that points resources.mycompany.com at read.uberflip.com. This takes anyone who goes to resources.mycompany.com to read.uberflip.com instead, but makes it look like they're still on resources.mycompany.com.
  • Finally, you register resources.mycompany.com as a custom domain on your Uberflip account, then associate it with the target Hub. This tells Uberflip's servers which Hub to serve up when a visitor arrives at read.uberflip.com from resources.mycompany.com.

 

Step 1: Choose a Subdomain Name

The first step is deciding what to name your Hub's new subdomain. This is where your visitors will go to access your Hub, so it's time to get creative! We recommend choosing something that describes what your visitors can expect to find in your Hub. Here are some examples to get you started:

  • resources.mycompany.com
  • insights.mycompany.com
  • learn.mycompany.com
  • community.mycompany.com
  • hub.mycompany.com

 

Step 2: Create the Subdomain and Set up a CNAME Record

When you have decided on the name for your Hub's subdomain, all that's left is to create it as a subdomain of your existing website. Initially, your newly created subdomain won't actually point at anything: anyone who goes there would see a 404 Not Found error. To fix that, you'll also need to point the subdomain at Uberflip's servers by creating a CNAME record with your hosting service provider.

In most cases, you'll need to have your website admin or IT team create the subdomain and set up the CNAME for you. Ask them to complete the following steps:

  1. Create a subdomain on the root domain. The specific subdomain name to be created is [fill in subdomain you chose, e.g. resources.mycompany.com].
  2. Create a CNAME record with your domain provider that points [fill in subdomain you chose] to the hostname read.uberflip.com (e.g. hub.mycompany.com CNAME read.uberflip.com) You can usually find instructions on how to create a CNAME record in your domain provider's help documentation.

Once the subdomain and CNAME record have been set up, you can test if it's working properly:

  1. Go to whatsmydns.net.
  2. In the URL field at the top, type in your new subdomain.
  3. Use the dropdown menu to select CNAME.

    Global_DNS_Propagation_Checker_-_What_s_My_DNS_.png
  4. Click on Search.
  5. In the list of servers shown on the page, you should see read.uberflip.com as the result for all servers, like this:

    Custom_Domain_and_SSL_Setup_Instructions_for_IT_Teams.png
  6. If you see any errors, let your website admin/IT team know so they can troubleshoot.

 

Step 3: Register the Subdomain in Your Uberflip Account

You've now set up your new subdomain so that anyone who visits it will be taken to Uberflip's servers at read.uberflip.com. However, your subdomain isn't associated with a Hub on the Uberflip side yet, so anyone who goes there would see an error saying that the Hub couldn't be found.

As a result, all that's left to do is to link the subdomain to your Hub in Uberflip. But before you can do that, you first need to add the subdomain to your Uberflip account so that it's available to be linked:

  1. Log in to your Uberflip account.
  2. In the top right corner, hover the mouse over your name to expand the menu, then click on Account Settings to go to your My Profile page.

  3. In the sidebar menu on the left, click on Services to expand that section, then click on Domains.

    Account___Domains_-_Uberflip.png
  4. On the right side, click on the + Add a Domain button.
  5. In the Add a Domain menu, type your custom subdomain into the field provided:
    Account___Domains_-_Uberflip.png
  6. Check the box next to I have read and agree to the Uberflip Terms of Use, then click on the Add Domain button.
  7. You should see a confirmation message that your domain was added successfully.
    • The message also contains a reminder that the new domain won't work until the CNAME record has been created. You should have already done that in Step 2, so you can disregard this reminder.

      Account___Domains_-_Uberflip.png

Info

When you add a domain to your account, it will have HTTPS encryption enabled on it by default. Uberflip will automatically provision and enable an SSL certificate (from Let's Encrypt) for your new  domain, so you don't need to provide your own certificate or perform any further setup. For more details on how this works, see this article.

 

Step 4: Link the Hub With the Subdomain

Now that you have registered your custom domain in your Uberflip account, the last step is to link it to the Hub you want it to point to. This tells Uberflip's servers to send visitors to that Hub when they arrive at read.uberflip.com from your subdomain.

  1. Log in to your Uberflip account, click on Hubs in the menu bar at the top, then click on the Hub for which you want to change the domain.
  2. In the sidebar menu, click on Hub Options to expand this section, then click on Change Hub Domain.
    Hubs___Options_-_Change_Hub_Domain_-_Uberflip.png
  3. You should now see Move Hub to Another Domain on the right. Use the Select a Domain dropdown menu to choose the subdomain you created earlier.
  4. Finally, click on Move Hub.
    Hubs___Options_-_Change_Hub_Domain_-_Uberflip.png
  5. Once your Hub has been moved to the new domain, you should see a message confirming this at the top of the screen.

That's it, you've successfully moved your Hub onto a custom domain. From now on, the subdomain URL you chose will be the main URL for your Hub.

Note

When you move a Hub onto a new domain, Uberflip automatically creates a redirect on the old domain, so that any old bookmarks will still work.

1 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.