Domains

Give your blog a professional home. Set up custom domains to host your content on your own domain name, creating a branded experience that builds trust and improves SEO.

Custom domains provide automatic SSL certificates, global CDN, and professional branding while maintaining all of Waldium's powerful content management features.

Why Use Custom Domains?

Custom domains transform your blog from a subdomain into a professional website that reflects your brand. Instead of yoursite.waldium.app, you can use blog.yourcompany.com or host at yourcompany.com/blog.

What custom domains enable:

  • Professional branding - Use your own domain name for credibility and trust
  • Better SEO - Custom domains improve search engine rankings and link authority
  • Brand consistency - Align your blog with your main website and marketing materials
  • Automatic infrastructure - SSL certificates, CDN, and global deployment included

Screenshot of the content generation modal showing style, tone, and length options

Accessing Domain Settings

  1. Navigate to Domains - Go to your dashboard and click on "Domains" in the settings
  2. View current status - See if you have a custom domain configured or need to add one
  3. Add new domain - Enter your full domain (e.g., blog.yoursite.com), optionally enable subpath hosting, and click "Connect Domain"

Hosting Modes

Waldium supports two hosting modes:

  • Name
    Subdomain
    Description

    Host your blog on a subdomain like blog.yoursite.com. Waldium handles DNS and SSL automatically. This is the simplest setup — just add a CNAME record.

  • Name
    Subpath
    Description

    Host your blog at a path like yoursite.com/blog. Your blog lives on your main domain, which is great for SEO. Requires configuring a reverse proxy on your infrastructure. Enable this by checking the "Use the subpath /blog" checkbox when adding your domain.

    Learn more about subpath hosting →


Adding a Custom Domain

  1. Enter your domain - Type the full domain you want your blog hosted on (e.g., blog.yourcompany.com) in the domain field. A preview above the field shows exactly what will be configured.
  2. Optionally enable subpath hosting - Check the "Use the subpath /blog" checkbox if you want your blog hosted at a subpath (e.g., yourcompany.com/blog). The preview updates to reflect this.
  3. Click "Connect Domain" - Waldium will add the domain to your configuration.

Domain Name Examples

Subdomain — Enter the full subdomain you want to use:

  • Enter blog.yourcompany.com → blog is hosted at blog.yourcompany.com
  • Enter news.yourdomain.com → blog is hosted at news.yourdomain.com

Subpath — Enter your domain and check "Use the subpath /blog":

  • Enter yourcompany.com with subpath enabled → blog is hosted at yourcompany.com/blog
  • Enter yourdomain.com with subpath enabled → blog is hosted at yourdomain.com/blog

DNS Configuration (Subdomain)

When using subdomain hosting, Waldium provides DNS records that you need to configure with your domain provider.

Understanding DNS Records

CNAME Records:

  • Used for subdomains (e.g., blog.yourcompany.com)
  • Points your subdomain to Waldium's servers
  • Most common setup for custom domains

A Records:

  • Used for root domains (less common)
  • Points your domain directly to an IP address
  • Requires specific IP configuration

Verification Records:

  • Proves you own the domain
  • Required for SSL certificate generation
  • Automatically provided by Waldium

TTL Settings:

  • Time-to-live for DNS records
  • Usually set to 3600 seconds (1 hour)
  • Can be adjusted based on your needs

Configuring DNS Records

  1. View DNS Records - DNS records are automatically displayed after you connect a subdomain
  2. Copy each record - Use the copy buttons to copy record values
  3. Add to your DNS provider - Log into your domain registrar and add these records
  4. Wait for propagation - DNS changes can take up to 48 hours to propagate

Common DNS Providers

Popular Domain Registrars:

  • GoDaddy - Navigate to DNS Management in your account
  • Namecheap - Go to Advanced DNS settings
  • Cloudflare - Use the DNS tab in your dashboard
  • Google Domains - Access DNS settings in your domain management
  • Route 53 - Use the hosted zone for your domain

Subpath Setup

When using subpath hosting, you need to configure your infrastructure to proxy /blog requests to Waldium. After connecting your domain, the setup card shows provider-specific guides:

  • Vercel - Use rewrites in your vercel.json or next.config
  • Cloudflare Workers - Proxy /blog traffic using a Cloudflare Worker
  • Nginx / Reverse Proxy - Configure a reverse proxy with location blocks
  • AWS CloudFront - Set up a CloudFront distribution with origin routing

For detailed instructions, see Subpath Hosting.


Domain Management

Viewing Your Domain

Once configured, your domain settings page shows:

  • Domain name - Your custom domain with a clickable link to visit it
  • Hosting type - Badge showing whether you're using subdomain or subpath hosting
  • Status - Whether your domain is Live or Not Configured
  • Management options - Refresh status, remove domain, access documentation

Status Indicators

  • Live (Green) - Domain is properly configured and serving content
  • Not Configured (Gray) - DNS records need to be configured (subdomain) or proxy setup is pending (subpath)

Refreshing Status

  • Click "Refresh Status" - Manually check your domain configuration
  • Automatic checks - System periodically verifies your domain configuration

Domain Verification

How Verification Works

  1. DNS Propagation - Wait for DNS changes to propagate (up to 48 hours)
  2. Automatic Checks - Waldium periodically verifies your domain
  3. SSL Generation - SSL certificates are automatically provisioned
  4. Content Serving - Your blog becomes available on your custom domain

Domain Removal

Removing a Custom Domain

If you need to remove your custom domain:

  1. Access domain settings - Go to your domain management page
  2. Click "Remove" - Use the remove button next to your domain
  3. Confirm removal - Confirm you want to remove the domain
  4. Revert to subdomain - Your site will return to yoursite.waldium.app

What Happens When You Remove

Immediate Effects:

  • Domain removed from Waldium configuration
  • DNS records no longer managed by Waldium
  • Site reverts to default subdomain
  • SSL certificate for custom domain is removed

Your Responsibility:

  • Remove DNS records from your domain provider
  • Update any links pointing to the custom domain
  • Notify users of the domain change

Was this page helpful?