If you’re adding a subdomain that’s part of a wildcard DNS setup that has A records pointed to multiple IP addresses, you’ll need to take a few extra steps to point that subdomain to Kinsta.

The steps below are only applicable when a wildcard (catch-all) subdomain is pointed to multiple A records.

If your domain does not use wildcard A records pointed to multiple IP addresses, you don’t have to go through these additional steps when adding a domain to your site.

To set up a wildcard subdomain that’s pointed to Kinsta, an additional wildcard subdomain (*.domain.com) is automatically added when you add a root/apex domain (domain.com) to a site in MyKinsta. You can point that wildcard subdomain to your Kinsta site the same way you point your root/apex domain, so you don’t have to add each subdomain individually in MyKinsta.

What Is a Multiple IP Wildcard Subdomain?

First, let’s define what it means for a wildcard subdomain to be pointed to multiple IP addresses. In most cases, a wildcard subdomain will have a single A record pointing to an IP address:

However, in some cases, a wildcard subdomain may point to multiple IP addresses. This kind of configuration is commonly used for DNS failover protection, round-robin setups, and more:

If you’re unsure whether your wildcard subdomain is pointing to multiple IP addresses, you can use a tool like WhatsMyDNS to check the A record(s) for the subdomain you want to point to Kinsta. In the screenshot below, you can see that the subdomain sub.brianli.dev is pointing to multiple IP addresses.

Subdomain pointing to multiple IP addresses.
Subdomain pointing to multiple IP addresses.

Next, you’ll need to check whether the DNS records pointing to multiple IP addresses are set up as static (e.g. sub.brianli.dev) or wildcard (*.brianli.dev) A records. If your DNS configuration looks similar to the one below (wildcard A records), you’ll need to proceed with the rest of this tutorial.

Wildcard subdomain pointing to multiple IP addresses.
Wildcard subdomain pointing to multiple IP addresses.

Adding a Multiple IP Subdomain in MyKinsta

If we detect that your subdomain is configured with multiple A records, you’ll see a message like the one below after adding the subdomain in MyKinsta:

Verification for subdomain pointing to multiple IP addresses.
Verification for domain pointing to multiple IP addresses.

Step 1 – Point Your Subdomain to Existing Wildcard IPs

First, you’ll need to create A records for the specific subdomain you’re trying to add to Kinsta. These A records should point to the same IP addresses as your wildcard A records.

For example, if you’re trying to configure sub.brianli.dev and have the wildcard A records below:

You should add the four A records below to sub.brianli.dev at your DNS provider.

Add multiple A records for your subdomain.
Add multiple A records for your subdomain.

This step is needed to keep the subdomain working and resolving properly until it’s verified and can be pointed to Kinsta.

Step 2 – Verify Your Subdomain

After you’ve added the A records, go to MyKinsta and click the Next button in the Verify Domain modal/pop-up.

Click Next in the Verify domain modal/pop-up in MyKinsta.
Click Next in the Verify domain modal/pop-up in MyKinsta.

You’ll be prompted to add one or more TXT records to verify ownership of your subdomain. The TXT record is formatted like the following:

TXT verification record details.
TXT verification record details.

Next, add this TXT record to your subdomain at your DNS provider.

Add TXT verification record.
Add TXT verification record.

After adding the TXT record, click Ok, I’ve Done It in MyKinsta.

Click OK, I’ve Done It in MyKinsta.
Click OK, I’ve Done It in MyKinsta.

Step 3 – Point Your Subdomain to Kinsta

MyKinsta will start the verification process for your subdomain. Depending on your DNS provider, this process may take a while due to DNS propagation. Once the verification has finished, you’ll see a Point domain button in MyKinsta.

Point domain button in MyKinsta.
Point domain button in MyKinsta.

Click the Point domain button, and you’ll see your Kinsta Site IP address.

Site IP address for subdomain in MyKinsta.
Site IP address for a subdomain in MyKinsta.

Next, go to your DNS provider and remove the A records for your subdomain that you added earlier.

Remove the A records for your subdomain that were added earlier.
Remove the A records for your subdomain that were added earlier.

Finally, add an A record for your subdomain pointing to your Kinsta Site IP address.

Add an A record for your subdomain pointing to Kinsta.
Add an A record for your subdomain pointing to Kinsta.

After setting up this A record, and after DNS has propagated, you’ll see a checkmark next to your subdomain in MyKinsta. This means the subdomain has been set up successfully.

Successful subdomain configuration in MyKinsta.
Successful subdomain configuration in MyKinsta.

Summary

By default, subdomains pointing to multiple IP addresses via wildcard A records are not immediately compatible with Kinsta’s Cloudflare integration. However, with a few additional configuration steps, you’ll be able to get your subdomain verified and pointed to Kinsta.

If you have any questions about your multiple IP subdomain setup, reach out to our 24/7 support team for further assistance.