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. This approach is particularly suitable if the main domain and the subdomain are to present different content. For example, your landing page can present your general services or products, while the subdomain leads to a special offer.

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. If you have used the A records or CNAME records, then the connection must be made directly with the domain provider.

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's take a look at this method using the following example: you have a project with the domain mypage.com and would now like to create another page under offer.mypage.com

Step 1: Create a New Project

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

Step 2: Find domain settings

Once you have created your new project, navigate to your Project Settings ➡️ Domain Settings. Click "Connect custom domain".

Step 3: Add Your Subdomain

Type in your subdomain, along with your root domain.

For example: offer.mypage.com

Step 4: Copy the CNAME-record

A CNAME-record is automatically generated for you. Copy the record and click on "OK, got it".

You will need this record in the next step.

Step 5: Edit DNS Settings for Your Root Domain

Go back to your project with the root domain (mypage.com) and navigate to your Project Settings ➡️ Domain Settings. Click on the three dots next to the primary domain and then "Edit DNS settings".

Step 6: Add the 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): offer

Target: whitelabel.onepage.io

TTL: 300

🎉 Done! You have successfully added a subdomain to your website! Now, you will have 2 projects: mypage.com and offer.mypage.com

📌 Please note: It may take 1-2 hours for the settings to be applied. During this time, the new subdomain may be offline.

Connect your Subdomain to an external service

Let's take a look at this method using the following example: you have a project with the domain mypage.com and you want to connect the subdomain offer.mypage.com to an external service.

Step 1: Edit the DNS Settings of your root Domain

Open the Onepage project, where you have connected your root domain and navigate to your Project Settings ➡️ Domain Settings. Click on the three dots next to the primary domain and then "Edit DNS settings".

Step 2: Add CNAME record

Add a new CNAME record.

Type: CNAME

Name: (enter the subdomain here): offer

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

TTL: 300 (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! You have successfully added a subdomain to your website! The mypage.com project is now connected to Onepage and the offer.mypage.com forwards to your external service provider.

Frequently asked questions and solutions

I have connected my subdomain to an external service provider, but the SSL certificate is not generated.

Please request a CAA record from your service provider. The CAA entry defines which service providers are authorised to generate the SSL certificate for your subdomain. Please add it to Onepage.

Is it possible to connect several subdomains in one project?

Yes, this is possible, but this function is only used to set up redirects. The number of subdomains can be limited, depending on your price plan.

If the main domain and the subdomain are to present different content, it is necessary to create an additional project.

How can I set up a domain redirect?

Modify DNS settings in Onepage (CAA, CNAME, TXT, SPF, MX)

💡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! 🙂