Skip to main content
Skip table of contents

Connect a Custom Domain

The custom domain feature allows you to make your Scroll Viewport site available under a domain your visitors know and are familiar with.

What You Need To Know Before Setting up Custom Domains

Before starting the process of setting up a custom domain, please make sure you meet the following requirements:

  • You already own a custom domain.

  • You have the ability to set up a CNAME records for the custom domain DNS name.

Want to use a custom domain you have used before?

Scroll Viewport’s custom domain feature will create a new CloudFront distribution for your site. Note that a custom domain is only allowed to be used once in any CloudFront distribution (for any AWS account).

If the custom domain you wish to use for your Scroll Viewport site is already used in a CloudFront distribution, Scroll Viewport will not be able to set up a new distribution until you remove the Alternate Domain Names (CNAME) from the other CloudFront distribution or delete the other CloudFront distribution completely. Both options can be accessed from your AWS console.

Please expect some downtime when transferring your custom domain to the Scroll Viewport site.

Are you using CloudFlare with the "proxied" setting?

Creating CNAME records in CloudFlare with the “proxied” setting is actually creating A-Records which won’t work with the custom domain feature in Scroll Viewport.

You need to switch the setting from “proxied” to “DNS only to solve that issue.

If you set up a custom domain, your reserved .scrollhelp.site domain will redirect incoming requests to the new custom domain. If you decide to delete the custom domain, your .scrollhelp.site domain will be reactivated, but there won’t be any redirects sent from the deleted custom domain to the scrollhelp.site domain.

If you have two or more Scroll Viewport sites, we recommend you set up one custom domain at a time.

How to Setup a Custom Domain

Follow these steps to set up a custom domain for your Scroll Viewport site:

  1. Navigate to the single site overview.

  2. Click the “settings” button on the top right.

  3. In the URL settings click the button “Setup custom domain”.

The 'site settings' dialog

Starting the process

To start the custom domain setup you need to:

  1. Enter a custom domain you already own that you wish to use for your Scroll Viewport site.

  2. Hit the “Start” button.

The first step of the custom domain setup process

This will start the setup process.

DNS configuration

This next step is to generate CNAME records for your custom domain. This step won’t take long.

  1. Copy the provided CNAME records.

  2. Add the CNAME records to your DNS configuration.

    1. Create a new CNAME record and add the first two values we provide as entries (Name + Value under Custom domain validation).

    2. Create another CNAME record and add the last two values we provide as entries (Name + Value under Certificate validation).

      The second step of the custom domain setup process
  3. Make sure that you CAA records allow for the AWS Certificate Manager (ACM) to issue a certificate for your domain or subdomain. Read more on Custom Domain Setup Fails

  4. Hit the “Next” button.

Please make sure you complete the required tasks as quickly as possible. After 72 hours the process will fail automatically if the CNAME couldn’t be found.

Validating DNS entries

This is an automated process and may take several hours. You can close the dialog – and the window if needed – and check back later.

The third step of the custom domain setup process

Currently, you won’t be notified once the validation is complete. You’ll need to manually check the status by reopening the dialog:

  1. Open the site settings again.

  2. Click on “more information” beside the URL configuration.

What happens in the background?

During this part of the process, your CNAME record is being searched for to set up the custom domain. If we can’t validate the record within 72 hours, the process will be canceled automatically and will need to be restarted manually.

Setting up the custom domain

Once the validation is successful, the custom domain for your Scroll Viewport site will start to be set up.
This step will run automatically in the background and could take a little while.

A completed custom domain setup process

What happens in the background

  1. We start creating a CloudFront distribution specific to that site.

  2. We wait until the CloudFront distribution is ready.

  3. We start polling the site with HTTP requests using the custom domain.

  4. Once we get a valid response using the custom domain, we mark the process as completed.

Success

When the setup was a success your site settings should look like this:

The site settings dialog when the custom domain is set up

You can always remove the custom domain, should you ever need to.

Please don’t delete the entries from your DNS configuration unless you no longer use the site or custom domain. Deleting the entries could make your site inaccessible under your custom domain.

Trouble with the setup?

Have you tried to set up a custom domain but haven’t been able to complete the process? Check out why your custom domain setup fails.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.