Skip to main content
All CollectionsForm, Portal & View Editor settingsAdvanced
How to use a custom domain for your extensions
How to use a custom domain for your extensions

How can I customize the URL for my form, portal, or shared view?

Updated over a month ago

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:

  1. First, make sure you've read the "Things to keep in mind" section above!

  2. Go to your domain registrar's DNS configuration (e.g., Cloudflare, Squarespace, GoDaddy, Namecheap, etc.).

  3. 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!

  4. 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.

  5. 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).

  6. 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.

  7. 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/mi5C0FPi24LbtcdXNbV4

  • Load the new URL in your web browser.

Frequently Asked Questions

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’ve ruled out the reasons mentioned above and still don’t see the Custom Domain section, it means your plan does not support this feature. Custom domains are only available for plans where they are explicitly listed as a feature, as well as legacy plans that originally included them on their feature list. Feel free to check our pricing page to see which plans currently offer this feature, and reach out to support if you’d like to upgrade!

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?

No, the extensions setting page will still be using web.miniextensions.com.

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?

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?

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.

Did this answer your question?