DeForm Custom Domain Setup Guide

DeForm Custom Domain Setup Guide
Do not index
Do not index


Setting up a custom domain for your form can enhance your branding, provide a professional appearance, and improve user experience.
This document will guide you through the process of configuring a custom domain in your form settings tab. Additionally, it will provide information about the types of domains accepted, specifically root domains and subdomains, and explain how to configure your DNS provider with the necessary records.

Configuring a Custom Domain

notion image

I. Types of Domains Accepted

When configuring a custom domain for your form, the following types of domains are accepted:
  1. Root Domain: A root domain is the main domain for your website or application, such as "". It does not contain any subdomains and represents the highest level in the domain hierarchy.
  1. Subdomain: A subdomain is a prefix to the root domain and allows you to create separate sections or subdivisions of your website or application. For example, "" is a subdomain of "".
Please note that slugs, which are additional path components in the URL (e.g., ""), are not accepted for custom domain setup at the moment. You can request for this feature here.
You also do not need to include the protocol (e.g. “https://” or “http://”) when adding the custom domain.

II. Configuring DNS Provider with Records

After adding a custom domain, you should see a To configure your DNS provider correctly, follow these general steps:
  1. Log in to your DNS provider's website or administration panel.
  1. Locate the DNS management section or a similar area where you can edit DNS records.
  1. Add a new DNS record, usually a type called "CNAME" (Canonical Name), to map your custom domain to your app's URL or endpoint.
  1. Enter the necessary details for the CNAME record:
      • Host/Name/Label: This should be the desired subdomain or leave it blank for the root domain.
      • Target/Points to/Value: Enter the URL or endpoint provided by your app's settings for custom domains.
  1. Save the changes or publish the DNS record.
  1. Wait for the DNS changes to propagate, which can take some time (usually a few minutes to several hours). During this time, your custom domain may not be accessible.
  1. Once the DNS changes have propagated, return to your app's settings tab and verify the custom domain configuration.
Note: DeForm uses Vercel to manage domains. If you are have added your domain before on another Vercel project, you must add an additional verification DNS record for _vercel that you must add to your DNS provider to complete the set up.
This is a TXT record that will be provided to you along with any other records you need to add.
notion image

II. Domain Verification

Once you have added the records to your DNS provider, DeForm runs a verification check to make sure the DNS records are set up and have propagated. You can always click Re-verify to update trigger this verification check.

Unverified Custom Domain

If you see a red badge with “Connection failed” after you have updated your DNS provider with the provided records, please follow the Troubleshooting steps below.
notion image

Verified Custom Domain

This means that the domain is active and you should be able to access your form at the configured domain.
notion image


Here are a few tips for troubleshooting
  1. Clear your browser cache or try accessing the custom domain from a different device or network to ensure you're not viewing a cached version.
  1. Double-check the DNS records for accuracy, paying attention to any typographical errors or missing characters.
  1. Ensure that the DNS records have propagated fully. You can use online DNS propagation checking tools to verify this.
  1. If the custom domain is still not working correctly, consult your DNS provider's documentation or our team at for further assistance.