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

1

Purchase a Domain

Buy a domain directly in Mocha or from your preferred domain registrar (e.g., Namecheap, GoDaddy, Squarespace Domains)

2

Access Domain Settings

In your Mocha project settings, navigate to the “Domains” section

3

Link Your Domain

Enter your domain name and follow the verification process. This will link your domain to your Mocha account.

This can take a while, up to 48 hours depending on the domain provider.

4

Associate the Domain with a Mocha Project

Select the project you want to associate the domain with.

Custom domain setup

5

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.