Attach a custom domain to a tenant

Set up a custom domain (like library.example.org) for a tenant.

Where

Super-admin → Libraries → click a library → Settings → Custom Domain

Workflow

• Enter the tenant's desired custom domain (library.example.org)
• Show them the DNS records to add at their registrar (CNAME pointing to cname.tryshelfwise.com)
• Wait for DNS propagation (5 min - 1 hour)
• Click "Verify" — we check the CNAME is set up
• SSL certificate is provisioned automatically
• The custom domain is live

Helping the tenant with DNS

Send them the CNAME record. Common questions:

• Type: CNAME
• Host: library (the subdomain part)
• Value: cname.tryshelfwise.com
• TTL: Auto or 3600

Tenant's main site

Their main site (e.g., yoursite.org) is not affected. Custom domain points to a subdomain like library.yoursite.org.

Multiple custom domains

A tenant can attach multiple custom domains. All point to the same library. Useful for libraries with branded sub-organizations.

Removing a custom domain

• Settings → Custom Domain → Remove
• The subdomain (yourname.tryshelfwise.com) still works
• DNS at the tenant's registrar can be removed