# Custom Domain



Once your project is deployed, you can attach a custom domain to it from the post-deployment panel. Ideavo links the domain through your active publish provider and shows the DNS records required by that provider.

## Accessing Custom Domains [#accessing-custom-domains]

Open the **Publish panel** after a successful deployment and click **Add a Custom Domain...**.

<DocImage src="features/custom-domain/add-domain-row" alt="The Publish panel after deployment with Add a Custom Domain highlighted" width="764" height="544" />

## Adding a Domain [#adding-a-domain]

<DocVideo src="features/custom-domain/setup" alt="Clicking Add a Custom Domain, entering a domain, seeing the DNS record to add, checking its status until it is verified, then managing it with the delete button" width="1120" height="1192" />

<Steps>
  <Step>
    Enter your domain (e.g. `example.com`) in the input field and confirm.
  </Step>

  <Step>
    Ideavo checks the domain against your active publish provider.
  </Step>

  <Step>
    If the domain is available, it gets added and the provider's required **DNS
    record type, name, and value** are shown in the same dialog.
  </Step>

  <Step>
    Add the DNS records to your DNS provider using the exact values shown.
  </Step>

  <Step>
    Click the 

    **refresh**

     icon next to the status to check whether DNS has propagated.
  </Step>
</Steps>

### Domain Check Results [#domain-check-results]

Before adding the domain, Ideavo verifies it against your active publish provider. There are three possible outcomes:

### Domain unavailable [#domain-unavailable]

The domain cannot be attached to this deployment. It may already be connected to another project or provider account. Remove it from the existing project or account before trying again.

### DNS setup required [#dns-setup-required]

The domain was accepted, but DNS still needs to be configured. Add the provider-required records shown in Ideavo to your DNS provider, then check status again.

### Domain added successfully [#domain-added-successfully]

The domain is available and gets attached to your deployment. Ideavo shows the DNS values returned by the active provider so you can configure DNS right away.

## DNS Configuration [#dns-configuration]

After the domain is added, configure it with your DNS provider using the values shown in the dialog. The exact record type depends on the publish provider and domain:

| Field     | Value                                                     |
| --------- | --------------------------------------------------------- |
| **Type**  | Returned by the active provider, such as CNAME or TXT     |
| **Name**  | Returned by the active provider, often `@` or a subdomain |
| **Value** | Returned by the active provider after the domain is added |

Once the record is saved with your DNS provider, click the **refresh** icon next to the status in the dialog to confirm propagation. DNS changes can take anywhere from a few minutes to 48 hours depending on your provider.

<Callout type="info">
  DNS propagation time varies by provider. If the status check fails, wait a few
  minutes and try again before making any changes.
</Callout>

### FAQ [#faq]

<Accordions>
  <Accordion title="Can I add multiple custom domains to one project?">
    Yes. You can add multiple domains from the Custom Domains panel. Each domain
    goes through the same availability check and DNS configuration process.
  </Accordion>

  <Accordion title="Do I need to redeploy after adding a custom domain?">
    No. The domain is linked to your existing deployment immediately. A redeploy
    is not required for the domain to point to your app.
  </Accordion>

  <Accordion title="What if DNS propagation takes too long?">
    Propagation typically completes within minutes to a few hours. If it's been
    over 24 hours, double-check that the DNS record was saved correctly with
    your DNS provider. A typo in the name or value is the most common cause of
    delay.
  </Accordion>

  <Accordion title="Can collaborators manage custom domains?">
    Admins and Editors can access the Publish panel and manage custom domains.
    Viewers have no access to the Publish panel.
  </Accordion>

  <Accordion title="What happens if I disconnect my publish provider?">
    Disconnecting Vercel or Railway only removes the saved integration from
    Ideavo. It does not delete provider-side deployments or domain configuration.
    To remove a custom domain from the provider, delete it from the Custom
    Domains panel before disconnecting, or manage it directly in the provider
    dashboard afterward.
  </Accordion>
</Accordions>
