Using a custom domain for your extensions allows you to replace web.miniextensions.com in your extension URLs with your custom domain, for example forms.yourdomain.com.
Please have a look at our Frequently Asked Questions below if you run into any issues or have any doubts about this feature!
Some things to keep in mind before you start
You need to have access to your domain's DNS configuration to set this up. You can find this on the platform you used to register your domain. Since each platform handles these settings slightly differently we cannot provide exact instructions for all of them in this guide, so please perform a search for "<insert your domain registrar's name here> add DNS record" to find the relevant instructions. Feel free to reach out to us if you're having trouble following those instructions. We'd be happy to help!
Naked domains (e.g. yourdomain.com) are not supported. Instead, use something like forms.yourdomain.com. In the vast majority of cases, you do not need to create a subdomain first! Please just follow the steps below to get set up.
DNS changes like adding new records can take up to 48 hours to fully propagate through the system and take effect, so please be patient during this process ๐
Step-by-step Instructions
Please complete all steps below to set up your custom domain:
First, make sure you've read the "Things to keep in mind" section above!
Go to your domain registrar's DNS configuration (e.g., Cloudflare, Squarespace, GoDaddy, Namecheap, etc.).
Create a new DNS record with the following information. Make sure you do not edit any existing DNS records, as this could break existing services like your website or email!
โType: CNAME
Name/Hostname/Host: your custom domain, e.g. forms.yourdomain.com (please see the note below to ensure you enter this correctly!)
Value/Target/Content/Data: domains.miniextensions.com
TTL: Leave at the default value
โPlease note: Many registrars (Squarespace, for example) only require the first part of the domain (e.g. forms instead of forms.yourdomain.com) to be entered in the Name/Hostname/Host field, but some will require the full domain (forms.yourdomain.com) in this field so please double check exactly what you need to enter in the corresponding field for your registrar!
โOnce your CNAME record is set up, go to the miniExtensions settings page and select the correct workspace on the left. In the Custom Domain section, enter your custom domain. Do not include http, www or other prefixes. Instead, just enter your custom domain itself, e.g. forms.yourdomain.com. Then click Add custom domain.
Our system will now validate your CNAME record. This can take anywhere from a few seconds to several hours, so please be patient. Please hit refresh to get the current status. If you see an error at this stage that means that there was an issue with your CNAME record's configuration. In this case, please double check your DNS configuration to ensure that everything was entered correctly (please make sure you read the note at the end of Step 3).
Once your CNAME record is validated, you will be shown a TXT DNS record that you need to add to your DNS configuration in addition to the CNAME record. This is used to validate domain ownership and is required to complete the setup! The note at the end of Step 3 also applies to the TXT record, so please make sure you enter this in the format expected by your registrar.
After adding the TXT record, the connection should be activated within a few hours. It will show "Active" next to your custom domain once this process is complete. You can always hit refresh to see the current status. In some cases DNS changes may take up to 48 hours to fully take effect.
How to use the custom domain
Once the custom domain is active, you can use it by following these steps:
Copy the link to your form, portal, or shared view.
Replace "web.miniextensions.com" with your custom domain (eg. forms.yourdomain.com). Your full URL will now look something like this:
https://forms.yourdomain.com/mi5C0FPi24LbtcdXNbV4Load the new URL in your web browser.
Frequently Asked Questions
Why don't I see the Custom Domain section in my workspace settings?
Why don't I see the Custom Domain section in my workspace settings?
This could be the result of one of three things:
You might have selected the wrong workspace on the left of your settings page.
To set up your custom domain, you need to have admin or owner privileges in your miniExtensions workspace. You can see your role in the Collaborators section. You can ask an Admin or the workspace Owner to change your role or activate the custom domain for you.
If you have ruled out the above reasons and are still not seeing the Custom Domain section, that means that your plan does not support this feature. Custom domains are only available on the Pro plan and some legacy plans. Feel free to have a look at our pricing page to learn about the Pro plan and reach out to support if you want to upgrade!
Which extensions are supported?
Which extensions are supported?
This feature only supports customer-facing extensions like the form, portal, and shared view.
Do I access my extension configuration through the custom domain?
Do I access my extension configuration through the custom domain?
No, the extensions setting page will still be using web.miniextensions.com.
Will any existing URLs or links to my extensions be affected?
Will any existing URLs or links to my extensions be affected?
No, the old URLs will still be functional. Links using the custom domain work simultaneously with the regular links using web.miniextensions.com.
Can I set different domains for different forms/portals within the same workspace?
Can I set different domains for different forms/portals within the same workspace?
No, you can configure only one custom domain per workspace. If you need to set up multiple custom domains, you would need to create additional miniExtensions workspaces, each with its own custom domain configuration.
Captcha is getting an error. Is this not supported in the custom domain?
Captcha is getting an error. Is this not supported in the custom domain?
If you require this feature to work with your custom domain, please contact us and we will enable it for you.
You can also embed the extension on your site as an alternative to using a custom domain.