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.
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.
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 setup 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.
You’ll find the custom domain set up in the site settings:
Navigate to the single site overview.
Click the “settings” button on the top right.
In the URL settings click the button “Setup custom domain”.
Starting the process
To start the custom domain setup you need to:
Enter a domain for your Scroll Viewport site.
Hit the “Start” button.
This will start the setup process.
This next step is to generate CNAME records for your custom domain. This step won’t take long.
Copy the provided CNAME records.
Add the CNAME records to your DNS configuration.
Create a new CNAME record and add the first two values we provide as entries (Name + Value under Custom domain validation)
Create another CNAME record and add the last two values we provide as entries (Name + Value under Certificate validation).
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:
Open the site settings again.
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.
What happens in the background
We start creating a CloudFront distribution specific to that site.
We wait until the CloudFront distribution is ready.
We start polling the site with HTTP requests using the custom domain.
Once we get a valid response using the custom domain, we mark the process as completed.
When the setup was a success your site settings should look like this:
Then you will have the option to remove the custom domain, should you ever need to.
Not getting to the success screen? Find out Custom Domain Setup Fails