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 record for the custom domain DNS name.

Want to use a custom domain you have used before?

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

If the custom domain you want to use for your Viewport site is already used in a CloudFront distribution, 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 Viewport site.

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, you only can setup one custom domain at a time. Starting the process for more than one at the same time won’t work.

How to setup a custom domain

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

You’ll find the custom domain set up in the site settings:

  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”.

Starting the process

To start the custom domain setup you need to:

  1. Enter a domain for your Scroll Viewport site.

  2. Hit the “Start” button.

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.

  3. Hit the “Next” button.

Please make sure to complete the tasks required for this part of the process 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.

Currently, you won’t get a notification once the validation is complete, you need to manually check the status by reopening the dialog. This is how you can check it:

  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.

Custom domain setup - setting up custom domain

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:

Custom domain setup - final screen

Then you will have the option to remove the custom domain, should you ever need to.