Skip to main content

How to use a custom domain and URL for your extensions

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

Updated yesterday

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. We also offer the option to customize the full URL of your extension, as well as a redirect for the custom domain itself.

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 🙂

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.

  • You can also optionally customize the second part to be in a more human-friendly format, e.g. https://forms.yourdomain.com/signup

  • You can also optionally set a redirect for your custom domain root. This can be used to redirect to your main form or portal for example. E.g. https://forms.yourdomain.com could redirect to https://forms.yourdomain.com/signup

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 customize an extension's full URL

Once you have set up a custom domain in your workspace, you can customize the exact URL through which an extension can be accessed, e.g.

https://forms.yourdomain.com/signup

instead of

https://forms.yourdomain.com/mi5C0FPi24LbtcdXNbV4

You can set this up by going to your extension, and then selecting URL Slug in the Options menu at the top. Make sure you confirm your choice with the Update button!

How to set up a redirect of the custom domain root

Once you have set up a custom domain in your workspace, you can set a custom domain root redirect. The setting for this can be found just underneath the custom domain setting itself, in your workspace settings. Simply make sure you enter a full, valid URL that a user should be redirected to and click the Update button!

With this feature, you can redirect users from your custom domain directly to your most used extension, for example:

A user accessing https://portal.yourdomain.com can be redirected to https://portal.yourdomain.com/customers.

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?