Skip to main content

​
Overview

Subdomain Routing lets you serve Anymorph pages from a dedicated subdomain while keeping your main domain unchanged. 
blog.yourdomain.com  → Anymorph pages
yourdomain.com       → Your existing site (no changes)
This is ideal when you want isolated content (like a blog, resource center, or comparison pages) without modifying your main site.

​
Prerequisites

  • Access to your DNS settings
  • Your workspace slug from Anymorph Dashboard

​
Setup Steps

1

Add ACME Challenge Record

Add this CNAME record to enable SSL certificate issuance:
TypeNameValue
CNAME_acme-challenge.blog_acme-challenge.blog.yourdomain.com.challenges.saascustomdomains.com
Replace blog with your subdomain name.
Adding this first enables zero-downtime setup. Your certificate is issued before traffic switches.
2

Wait for SSL Verification

In Anymorph Dashboard, wait until the SSL status shows Active.This typically takes 5–15 minutes.
3

Add A Records

Once SSL is active, add these A records:
TypeNameValue
Ablog99.83.186.151
Ablog75.2.96.173
Add both A records for high availability.
4

Verify Connection

Test your setup:
curl https://blog.yourdomain.com/__check__
Expected response:
{"status": "connected", "domain": "blog.yourdomain.com"}

​
DNS Provider Guides

  1. Go to DNS > Records
  2. Click Add Record
  3. Add the ACME CNAME:
    • Type: CNAME
    • Name: _acme-challenge.blog
    • Target: _acme-challenge.blog.yourdomain.com.challenges.saascustomdomains.com
    • Proxy status: DNS only (gray cloud)
  4. After SSL is active, add A records:
    • Type: A, Name: blog, IPv4: 99.83.186.151
    • Type: A, Name: blog, IPv4: 75.2.96.173
Use DNS only mode (gray cloud). Cloudflare’s proxy can interfere with SSL.
  1. Go to My Products > DNS
  2. Click Add under DNS Records
  3. Add the ACME CNAME first
  4. After SSL verification, add both A records
  1. Go to Domain List > Manage > Advanced DNS
  2. Click Add New Record
  3. For CNAME, enter the subdomain name in Host (e.g., _acme-challenge.blog)
  4. For A records, enter just the subdomain name (e.g., blog)
  1. Go to Hosted Zones and select your domain
  2. Click Create Record
  3. Enter your subdomain name (e.g., blog)
  4. Set Record type to A
  5. Add both IP addresses
# CLI example
aws route53 change-resource-record-sets \
  --hosted-zone-id Z1234567890 \
  --change-batch '{
    "Changes": [{
      "Action": "CREATE",
      "ResourceRecordSet": {
        "Name": "blog.example.com",
        "Type": "A",
        "TTL": 300,
        "ResourceRecords": [
          {"Value": "99.83.186.151"},
          {"Value": "75.2.96.173"}
        ]
      }
    }]
  }'
  1. Go to DNS settings
  2. Click Manage custom records
  3. Add the ACME CNAME record
  4. Add both A records for your subdomain

​
Common Subdomain Patterns

SubdomainUse Case
blog.example.comCompany blog, news, updates
learn.example.comTutorials, guides, resources
compare.example.comProduct comparisons
vs.example.comX vs Y comparison pages
guides.example.comHow-to guides
resources.example.comDownloadable resources, whitepapers

​
Subdomain Status

After configuration, your subdomain will show one of these statuses:
StatusMeaning
Pending SSLWaiting for ACME challenge verification
SSL ActiveCertificate issued, waiting for A records
ActiveFully configured and serving traffic
DNS propagation typically takes 5–30 minutes but can take up to 48 hours.

​
Troubleshooting

  • Verify the ACME challenge CNAME is correct
  • Check for typos in the record value
  • Ensure no CAA records are blocking certificate issuance
  • The value must end with .challenges.saascustomdomains.com
  • Verify both A records are added: 99.83.186.151 and 75.2.96.173
  • Check DNS propagation at whatsmydns.net
  • Allow up to 48 hours for full propagation
  • Clear your browser cache
  • Verify the subdomain is registered in Anymorph Dashboard
  • Check that your pages are deployed to this subdomain
  • Wait for SSL certificate to fully propagate
  • Ensure all resources on your pages use HTTPS

​
FAQ

No. Subdomain Routing only affects the specific subdomain you configure. Your main domain remains completely unchanged.
Yes. You can configure as many subdomains as needed. Each requires its own DNS setup.
No. MX records are separate from A records. Email routing is unaffected.
Yes. Add the new subdomain configuration, migrate your content, then remove the old subdomain.
Subdomains are treated as separate sites by search engines. Content on blog.example.com builds its own domain authority, separate from example.com.
A records provide more reliable routing and work consistently across all DNS providers. CNAME records can have compatibility issues with some configurations.