How to add Subdomain to your root domain

If necessary, it is possible to add a subdomain to your custom domain by creating an additional project in Onepage.

Prior to doing so, please ensure that your custom domain has been properly connected. Please refer to our manual for further guidance:

How do I link my own domain to Onepage

❗️ Important: your root domain must be connected via Name Server.❗️

After you have successfully connected your domain, you can connect your subdomain, either internally, to a new Onepage Project or to an external service. Both cases are described below.

Connect your Subdomain internally, to a new Onepage Project.

Let us assume your root domain is your-website.com

Step 1: Create a New Project

Simply go to your "projects" tab in Onepage and click "create project".

Step 2: Go to Project Settings ➡️ Domain Settings

Once you have created your new project, navigate to your project settings and select "Domain Settings" from the menu. Click "transfer domain".

Step 3: Add Your Subdomain

Type in your chosen subdomain, along with your root domain.

For example, if your root domain is your-website.com, you could choose to add the subdomain go. The result should look like this: go.your-website.com

Step 4: Select the "Via CNAME-Record" Option

In order to successfully add your subdomain, we will choose the "via CNAME-Record" option.

Copy the CNAME value and click on the "Check" button.

You will need this value in the next step.

Step 5: Edit DNS Settings for Your Root Domain

Go back to your project with the root domain (your-website.com) and select "Domain Settings" from the project settings menu. Then, click on the "Edit DNS settings" button.

Step 6: Add a New CNAME Record

In the DNS settings, you will need to add a new record in order to successfully connect your subdomain. Make sure to follow the instructions below:

Type: CNAME

Name (this is where you type your subdomain): go

Target: whitelabel.onepage.io

TTL: 5 min.

🎉 Done! Now You Have 2 Projects

Congratulations, you have successfully added a subdomain to your website! Now, you will have 2 projects: your-website.com and go.your-website.com.

Please note that it may take 1–2 hours (or even up to 24 hours in rare cases) for the settings to be applied. During this time, your new subdomain may be offline, but do not worry, this is normal.

Connect your Subdomain to an external service

Let us assume, that you have a root domain your-website.com, and you want to connect the subdomain "go" externally.

First, make sure, your root domain is connected to Onepage properly. After that, please follow these steps:

Step 1: Edit the DNS Settings of your root Domain.

Open the Onepage project, where you have connected your root domain and go to project settings and select domain settings -> edit.

Step 2: Add CNAME record.

Add new CNAME record.

Type: CNAME

Name: go

Target: This value must be provided by the external service, you want to connect to.

TTL: 5 min (or follow the instructions of the external service)

Please note! In this case, the SSL certificate can only be created by the external service. Onepage does not provide the SSL in this case. It might be needed to add a CAA record in Onepage for that. See our article explaining how to add CAA record.

🎉 Done!

💡Do you have any feedback concerning this article? Please let us know through our live chat or at support@onepage.io, so we may keep it up to date. Thank you! 🙂