Custom domains

​

Overview

Custom domains let you serve your hosted forms from your own domain instead of the default Formbox URL. Instead of sharing https://app.formbox.app/forms/abc123, your respondents will see a clean, branded URL like https://forms.yourdomain.com. Custom domains are managed at the organization level, so any member with Admin or Member access can add and verify domains from the Domains page. Once a domain is verified, it can be assigned to a hosted form from that form’s Custom domain settings.

​

Adding a custom domain

1. Navigate to Domains in your organization’s dashboard sidebar.
2. Click Add domain to open the dialog.
3. Enter your domain name — this can be a subdomain (e.g. forms.example.com) or a root domain (e.g. example.com).
4. Click Add domain.

The domain will be created and added to your organization’s domain list with a Misconfigured status.

​

Configuring DNS records

After adding a domain, Formbox will display the DNS records you need to configure with your domain registrar or DNS provider.

• Subdomains (e.g. forms.example.com) — Add a CNAME record pointing to the value shown in the DNS records panel.
• Root/apex domains (e.g. example.com) — Add an A record pointing to the IP address shown in the DNS records panel.

Some domains may also require a TXT record for verification. If a TXT record is required, it will be displayed alongside the other records.

​

Verifying your domain

Once you’ve added the DNS records, click the Refresh button on your domain card to check the verification status. Your domain will go through the following statuses:

​

Assigning a domain to a form

Once your domain is verified, you can assign it to a hosted form:

1. Open the form and navigate to the Settings tab.
2. Scroll down to the Custom domain section.
3. Click Connect domain.

4. A dialog will open titled “Connect a custom domain”. Select one of your verified domains from the searchable dropdown.
5. Click Connect to assign the domain to your form.

Your form will now be accessible at the root of your custom domain (e.g. https://forms.example.com). To disconnect a domain from a form, go back to the Custom domain section in form settings and click Disconnect.

​

Sharing your form with a custom domain

Once a custom domain is assigned to your form, the Share tab will automatically use that domain URL as the primary share link. The default Formbox URL is still available as a fallback. QR codes generated for your form will also use the custom domain URL.

​

Removing a custom domain

To remove a custom domain:

1. Go to the Domains page in your organization dashboard.
2. Click the more options menu (three dots) on the domain you want to remove.
3. Select Remove and confirm.

Removing a domain will disconnect it from Formbox and any assigned forms. The form will revert to using the default Formbox URL.

​

Troubleshooting

​

Domain stuck on “Pending DNS”

• Double-check that the DNS records match exactly what Formbox shows in the records panel.
• Make sure you’re editing DNS for the correct domain at your registrar.
• Wait a few minutes and click Refresh again — DNS propagation can take time.

​

Domain shows “Misconfigured”

• Verify that the record type (A vs CNAME) is correct for your domain type.
• Subdomains should use a CNAME record, root domains should use an A record.
• Some DNS providers add a trailing dot to records — this is normal and should not cause issues.

​

Verification TXT record failing

• Make sure the TXT record is added to the exact hostname shown (often prefixed with _vercel).
• Some providers require you to omit your domain from the record name — check your provider’s documentation.