Atomicwork allows you to configure a custom vanity URL for your portal (e.g., support.yourcompany.com) instead of using the default address (e.g., company.atomicwork.com). This helps align the portal with your organization's branding for building trust with your employees.
Configure a custom vanity URL
You can set up a custom domain from your organization settings. This process involves generating specific DNS records in Atomicwork and adding them to your domain provider's settings.
Navigate to Settings > [Organization] General > Domains. Your default Atomicwork URL will be displayed onscreen. This URL will remain active and available even after a custom domain is configured.
Click Add your domain and enter your desired domain (e.g.,
help.acme.com).Atomicwork will generate unique CNAME and TXT records for your tenant.
Update your DNS records
Once you have the records from Atomicwork, you need to add them to your company's DNS configuration to verify ownership and point the traffic correctly.
Log in to your DNS provider (like GoDaddy, Cloudflare, or Route 53).
Navigate to the DNS management section for your domain.
Add the CNAME record provided by Atomicwork.
Add the TXT record provided by Atomicwork.
Detailed instructions specific to common DNS providers are often available within your provider's help center.
Verification and SSL provisioning
After updating your DNS records, Atomicwork will periodically check the configuration. The status indicators will update as follows:
Pending DNS: The system is waiting for the DNS records to propagate and be detected.
Pending SSL: Once DNS is verified, the system automatically provisions an SSL certificate for your domain. This is handled via Let's Encrypt and auto-renews.
Connected: The portal is now accessible via HTTPS at your custom vanity URL.
If validation fails (e.g., missing records or expired SSL), the system will display an error message. In such cases, the portal automatically falls back to the default Atomicwork URL to prevent downtime.
Update or delete a vanity URL
Each tenant can configure only one vanity URL at a time.
To delete: Click the three dots icon to remove the vanity URL configuration at any time. Traffic will instantly revert to the default Atomicwork URL.
To update: You must first delete the existing vanity URL and then configure a new one following the steps above.
Next Steps
Once your domain is configured, you might want to further customize your portal's appearance. See our guide on customizing branding in Atomicwork to update your logo and AI assistant's name.