Custom Domains
Learn how to connect your own domain to your Mocha project
Overview
Mocha supports custom domains, allowing you to deploy your Mocha applications to your own domain. This feature gives you complete control over your website’s URL and branding.
Domain Limits by Plan
- 🥉 Bronze: 1 custom domain
- 🥈 Silver: 5 custom domains
- 🥇 Gold: 20 custom domains
These limits are subject to change as we continue to evolve our offerings.
How to Set Up Your Custom Domain
Purchase a Domain
Buy a domain directly in Mocha or from your preferred domain registrar (e.g., Namecheap, GoDaddy, Squarespace Domains)
Access Domain Settings
In your Mocha project settings, navigate to the “Domains” section
Link Your Domain
Enter your domain name and follow the verification process. This will link your domain to your Mocha account.
Associate the Domain with a Mocha Project
Select the project you want to associate the domain with.
Custom domain setup
Publish your Project
Once the domain is connected, you can simply publish as usual, and your Mocha app will be live at your custom domain.
Troubleshooting
Common issues and solutions:
- Stuck in “Verifying”: Changes can take up to 48 hours to propagate. Typically though it happens within 1h. You can contact support if you’re unsure and would like some help.
If you’re having trouble connecting your domain, check our troubleshooting guide or contact support.
Managing Multiple Domains
For users on Silver and Gold plans, you can manage multiple domains:
- Add new domains at any time
- Remove domains from your project
- Monitor domain status
- Configure domain-specific settings
Need more domains? Consider upgrading your subscription to get access to more custom domains.
Purchase Domains Through Mocha
We’ve partnered with IONOS, a leading domain registrar, to offer seamless domain purchases directly within Mocha. This integration allows you to search, purchase, and manage your domains all in one place.
Access the domain purchase modal from your project settings
Benefits of Buying Through Mocha
- Streamlined Process: Search and purchase domains without leaving Mocha
- Instant Setup: Domains purchased through Mocha are automatically linked to your account
- Competitive Pricing: Access to IONOS’s competitive domain pricing
- Easy Management: Manage all your domains in one place
After purchasing a domain through Mocha, you can follow the regular domain linking process to associate it with your project.
Buying through Mocha is the fastest way to get started with a custom domain, but you can also purchase or use domains from other registrars.