Custom Domains for Web3 Profiles: Setup and Benefits

Introduction

Your Web3 identity card deserves a URL that reflects who you are. Instead of sharing a generic platform link, custom domains let you use your own branded address — like card.yourname.com — to host your Sovereign Card profile.

This guide covers why custom domains matter, how the technical flow works, and how to set one up.

Why Custom Domains Matter

Professional Branding

A custom domain signals permanence and professionalism. In a space full of ephemeral links and disposable accounts, owning your URL differentiates you.

Memorable Sharing

card.yourname.com is easier to remember and share than a random subdomain with a hash. This matters for social media bios, business cards, and verbal introductions.

Domain Ownership as Identity

In Web3, sovereignty matters. Owning the domain that hosts your identity card is consistent with the self-sovereign ethos — no platform can change or revoke your URL.

SEO Benefits

Custom domains with your name or brand build search engine presence over time. Your identity card becomes a persistent, indexable web property.

How It Works in Sovereign Card

The Flow

User adds domain: In Sovereign Card Settings, the user enters their desired subdomain (e.g., card.yourname.com)
API registers domain: The backend calls the Vercel REST API to add the domain to the deployment project
DNS configuration: The user creates a CNAME record at their registrar pointing to cname.vercel-dns.com
Verification: The user clicks "Verify DNS" in Settings, which checks domain ownership via the Vercel API
Routing: Next.js middleware detects the custom hostname and rewrites the request to the user's profile page

Technical Details

The middleware checks every incoming request's hostname. If it does not match the default app domain, it looks up the custom domain in the database, finds the associated wallet address, and serves that user's profile page.

Request: card.yourname.com
→ Middleware: hostname ≠ card.svgn.org
→ DB lookup: card.yourname.com → wallet 0x7a3b...9f2d
→ Rewrite: /_custom-domain/card.yourname.com
→ Render: Profile for 0x7a3b...9f2d

SSL and Security

Vercel automatically provisions and renews SSL certificates for custom domains. Users get HTTPS by default without any manual certificate management.

Setup Guide

Prerequisites

A Sovereign Card Pro account (one-time upgrade)
A domain name with DNS management access
A few minutes for DNS propagation

Step 1: Add Domain in Settings

Navigate to Settings in Sovereign Card, enter your desired subdomain, and click "Add Domain."

Step 2: Configure DNS

At your domain registrar, create a CNAME record:

Type	Name	Value
CNAME	card	cname.vercel-dns.com

If you are using an apex domain (yourname.com without a subdomain), you may need an A record instead, depending on your registrar's support for CNAME flattening.

Step 3: Verify

Return to Sovereign Card Settings and click "Verify DNS." The system checks whether the CNAME record resolves correctly. Verification usually succeeds within minutes but can take up to 24 hours.

Troubleshooting

Verification fails immediately: Double-check the CNAME value for typos
Verification hangs: DNS propagation can take up to 48 hours in rare cases
Conflicting records: Remove any existing A or AAAA records for the same subdomain
Registrar limitations: Some registrars do not support CNAME on apex domains — use a subdomain instead

The Pro Upgrade

Custom domains are a Pro-only feature. The upgrade is a one-time payment via Stripe Checkout — no subscriptions, no recurring billing. Once upgraded, your Pro status is permanent.

Conclusion

Custom domains transform your Sovereign Card from a shared-platform profile into a personal web property. The setup takes minutes, the benefits last as long as you own the domain, and the result is a professional, memorable, and self-sovereign Web3 identity.