Support
Documentation

Use a custom domain with your schedule

This tutorial demonstrates how to create a custom web address (URL) for your schedule. Creating a custom web address allows your users to access your schedule with a link such as www.your-company-schedule.com. Links in confirmation emails will also use this domain. This helps reassure users that the schedule belongs to you.

Setting up a custom domain requires modifying your DNS. Incorrectly modifying DNS entries can potentially make your site, as well as your email, unreachable. Many of the steps detailed in this tutorial are outside the control of SuperSaaS, we provide these instructions as a service only and cannot help you troubleshoot technical issues that may arise. Some technical proficiency is required.

The procedure of creating a custom domain name that points to supersaas.com is relatively straightforward. A complicating factor is that every domain registrar uses different software, so it’s hard to give step-by-step instructions. A second complication is that nowadays customers expect to have an SSL encrypted (https) connection on pages where they enter their information, and modern browsers show a warning message when a connection is not secure. Therefore, it is advisable set up the domain so that it can be reached on https. Adding SSL encryption on a custom domain is a bit harder as it requires the use of a so-called “proxy”. In this tutorial, we will explain how you can add Cloudflare as a proxy to SuperSaaS so that your custom domain is SSL encrypted.

Step 1: Choose: Create a new domain or migrate an existing domain

You can migrate the DNS of your existing domain to Cloudflare to create a subdomain like schedule.your-company.com or you can purchase a new domain for the purpose with a name like your-company-schedule.com. Due to high risk involved in migrating your DNS, some Internet Service Providers do not allow you to modify the DNS yourself. If your provider does not allow DNS modification or if you are not comfortable in modifying your DNS, your best option would be to buy a new domain for this purpose. You can easily buy a cheap domain for as little as a few dollars per year from domain name providers like NameCheap or Gandi. SuperSaaS does not sell domain names.

Step 2: Create a Cloudflare account

Once you have access to the name servers of the domain that you want to use you can create a free Cloudflare account. If you have an existing domain, then the setup process tutorial at Cloudflare will help you with the migration.

Step 3: Point a (sub)domain to SuperSaaS

Once the domain is under the control of Cloudflare, you can go to ‘My Dashboard’ inside your Cloudflare account and create a subdomain that will point to your schedule.

Add a record on Cloudflare

On your DNS control panel, go to advanced DNS settings and add a ‘CNAME’ record to your DNS. While creating a new CNAME, you need to enter an alias and a destination address that it should point towards. The alias is the part that will be the subdomain of your site, a name like ‘schedule’ or ‘booking’ would be a good choice. For example, if you have the domain yourcompany.com, then the complete domain name would be schedule.yourcompany.com. The destination or host address that it points to should be www.supersaas.com.

Point CNAME to supersaas.com

Do not put in the entire URL to your schedule, so just enter www.supersaas.com, not the /schedule/… part. The SuperSaaS system can figure out the rest of the URL once you have linked your domain to your account (in the next step).

DNS changes propagate slowly and may take up to 24 hours sometimes before they take effect. When some time has passed, you can try accessing your new domain by typing it into a browser. If you followed the procedure correctly, you would be directed to the SuperSaaS homepage (but not yet your schedule). If you already entered your custom domain on your account (as explained in the next step), you would see a screen explaining that your domain still has to be linked to your account. Only after this works correctly should you continue with the next step.

Step 4: Link your domain to your account

You can now access your schedule by replacing the www.supersaas.com part in your schedule with your custom domain. The next step is to link the domain to your account. Linking the domain to your account provides you with two additional benefits: Firstly, the custom domain will be used in all outgoing email messages that mention a URL, such as reminders. Secondly, if a visitor points his browser at the bare domain name, without the /schedule/… part, the system will redirect him to your account instead of to the SuperSaaS homepage.

To link your domain to your SuperSaaS account:

  1. On your Dashboard, select Layout Settings and scroll down to the Appearance section. Here you will find an Advanced Settings link.
  2. On the Advanced Settings page, you’ll find a section labeled Using Your Own (Sub)Domain where you can enter the (sub) domain name you set up earlier.
  3. When you check Confirm this domain and link it to account… and click Save changes, the system will check if the URL does indeed resolve to SuperSaaS to ensure the links in reminder and confirmation emails sent are really correct. This check also helps ensure someone else cannot incorrectly link to your schedule.

You can have multiple schedules in one account and they all use the same custom domain. The supervise screen of the individual schedules will tell you the URL to reach a particular schedule. If you have multiple schedules and someone enters just the domain part of your custom URL, he can either be shown a list of your schedules to choose from, or be redirected to first schedule on your dashboard. On the Access Control page under the heading What happens when you access… you can select whether your domain will show the user a list of available schedules, or if it should just show the first schedule.

You can point multiple subdomains to the same account. For example, if you want both www.myschedule.com and myschedule.com to work, then enter only the myschedule.com part. If instead you want schedule1.example.com and schedule2.example.com to point to two different accounts, enter the entire domain name.

The top-level domain controls the default language the visitor sees. So a domain ending in .de would show a German language schedule. Anything for which the language cannot be determined, such as .com or .org will use the default language specified in Layout Settings. You can force the page to a particular language by adding ?lang=xx to a URL, where xx is an ISO language code such as fr or en for French and English respectively.

Step 5: (recommended) Force upgrade to SSL on Cloudflare

Our server upgrades http connections to https on the login page and on payment pages. Regular http connections would otherwise show an alarming warning in modern browsers, which we want to avoid. However, our server cannot accurately detect the situation where users are connected to Cloudflare via https, but connected to SuperSaaS on the second leg via http. In that case the user will be forwarded to a SuperSaaS https domain which we know to be safe. This is probably not what you want, as it would show supersaas.com in the browser bar, not your custom domain. To prevent this situation, make sure that Cloudflare encrypts the traffic to SuperSaaS. It’s a simply one-click setting in the menu “SSL/TLS” choose the option “Full” (or “Full (strict)”), see screenshot.

Enable SSL encryption

If you want to ensure that users who accidentally land on an old http link are automatically redirected to https you can configure Cloudflare to do so. On the tab “Edge Certificates” choose the option “Always use HTTPS”, see screenshot.

Always use HTTPS

SuperSaaS offers a similar setting on its Access Control page, however, you typically would not want to use that one, because the only way for our server to enforce SSL/TLS is by redirecting your users to a SuperSaaS https domain, again ignoring your own custom domain.