> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypeframe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect a custom domain

> Use your own domain name for your deployed HypeFrame application. Connect your domain in just a few steps.

<Warning>
  Custom domains are a paid feature. You'll need a Pro or Pro Plus plan to
  connect a custom domain to your deployment.
</Warning>

## Before you start

Before connecting a custom domain, make sure you have:

* **Deployed your application** - Your project must be deployed first. If you haven't deployed yet, see our [deployment guide](/build/deployment).
* **A domain name** - You need to own a domain name (like example.com) from a domain registrar
* **A paid plan** - Pro or Pro Plus plan is required for custom domains

## Connect your custom domain

<Steps>
  <Step title="Open your project">
    Go to the project you want to connect a domain to. Make sure the project is already deployed.
  </Step>

  <Step title="Open options menu">
    Inside your project, look for the options menu in the top right corner. Click
    on it to see available options.
  </Step>

  <Step title="Select connect custom domain">
    In the options menu, you'll find the "Connect Custom Domain" option. Click on
    it to start the connection process.
  </Step>

  <Step title="Enter your domain">
    You'll see a field to enter your domain name. Type in your domain (for
    example: example.com or [www.example.com](http://www.example.com)).

    <Tip>
      You can connect both the root domain (example.com) and the www subdomain
      ([www.example.com](http://www.example.com)) if needed.
    </Tip>
  </Step>

  <Step title="Click connect">
    After entering your domain name, click the "Connect" button. HypeFrame will
    start the connection process.
  </Step>

  <Step title="Wait for DNS propagation">
    After clicking connect, it will take a few minutes for DNS propagation to
    complete. During this time, HypeFrame is configuring your domain to point to
    your deployment.

    <Info>
      DNS propagation typically takes 5-15 minutes, but can sometimes take up to
      24 hours depending on your domain registrar and DNS settings.
    </Info>
  </Step>

  <Step title="Domain is connected">
    Once DNS propagation is complete, your custom domain will be connected to your specific deployment. You'll receive an email confirmation with the connection details, including your project ID. Your application will be accessible at your custom domain.
  </Step>
</Steps>

## How it works

When you connect a custom domain:

1. **HypeFrame configures DNS** - Sets up the necessary DNS records to point your domain to your deployment
2. **SSL certificate** - Automatically provisions an SSL certificate for secure HTTPS access
3. **Domain verification** - Verifies that you own the domain
4. **Connection complete** - Your domain is connected to that specific deployment

<Info>
  Each deployment can have its own custom domain. If you deploy a new version,
  the domain stays connected to that deployment.
</Info>

## Important notes

### Domain ownership

You must own the domain you're trying to connect. HypeFrame will verify domain ownership during the connection process.

### DNS settings

HypeFrame automatically configures the necessary DNS records. You don't need to manually edit DNS settings in most cases, but you may need to verify domain ownership with your registrar.

### Deployment requirement

You must deploy your project before connecting a custom domain. The domain connects to a specific deployment, so make sure your project is deployed and working correctly first.

### Multiple domains

You can connect multiple domains to the same deployment if needed. Each domain will point to the same application.

## Troubleshooting

### Domain not connecting

If your domain isn't connecting:

* Make sure your project is deployed
* Verify you have a Pro or Pro Plus plan
* Check that you entered the domain name correctly
* Wait a bit longer—DNS propagation can take time
* Verify domain ownership with your registrar

### DNS propagation taking too long

If DNS propagation is taking longer than expected:

* DNS changes can take up to 24 hours in some cases
* Check your domain registrar's DNS settings
* Verify that DNS records are being updated
* Contact support if it's been more than 24 hours

### Domain not working after connection

If your domain is connected but not working:

* Wait a few more minutes for DNS to fully propagate
* Clear your browser cache
* Try accessing the domain from a different network
* Check that your domain registrar's DNS is working correctly

### SSL certificate issues

If you're having SSL certificate problems:

* SSL certificates are automatically provisioned—this may take a few minutes
* Make sure your domain is properly connected
* Wait for the certificate to be issued (usually within minutes)
* Contact support if issues persist

<Warning>
  Make sure your domain is properly configured with your registrar before
  connecting. Incorrect DNS settings can prevent the connection from working.
</Warning>

## Need help?

<Info>
  Having trouble connecting your domain? Questions about DNS or SSL
  certificates? Reach out at [contact@hypeframe.ai](mailto:contact@hypeframe.ai)
  for assistance.
</Info>