Custom Domains

Custom Domains
Custom Domains allow you to create branded URLs that match your website to use with your forms. You'll setup a single root domain and as many subdomains as you'd like. When you combine this feature with our Form Alias feature, you can create exactly the URL that you want. 

Want to see how to setup a Custom Domain, Subdomains and a Form Alias?  Watch the video

The structure of the URL looks like this:

subdomain.rootdomain.com/form-alias


Here are some examples of what you might set up:

give.yourorganization.org/donate

membership.yourorganization.org/join-today

subscribe.yourorganization.org/2023-digital-season

Custom Domains and Form Aliases are not available on original Donate2 Quick Donation Forms or Team Fundraising Forms as they were built on V1.0 form technology. 


What is a root domain?
For the context of this feature, a root domain is the domain you or your organization/company control.

Examples of root domains:

donate2.com

nyphil.org

adella.live


What is a subdomain?
For the context of this feature, a subdomain is the portion of a URL that comes before the root domain name and the domain extension.

Examples of subdomains:

support.donate2.com

giving.nyphil.org

activate.adella.live


Domain Management Menu

To set up or mange a Custom Domain, navigate to the Domain Management feature from the drop down menu on the right under your user. 

Only Admins and Owner users have access to manage this feature. You will need to set up 2 or more DNS records during this process, which will most likely require assistance from IT services or whoever manages that at your organization.


Add A Root Domain

The first step that needs to be completed before you can add a subdomain is to configure your root domain. To do this, enter your root domain and click save. Your organization need to either own or be associated with the domain used in this step. 


CAA Certification Authority Authorization
When attempting to generate an SSL Certificate, we check to see if you have a CAA setup. If you do, we check the CAA Record on your DNS to see if you've have at least 1 of the 4 CA domain names required for AWS Certificate Manager (ACM) to generate an SSL Certificate. 

ACM Documentation
https://docs.aws.amazon.com/acm/latest/userguide/setup-caa.html

Our Domain Management tool will provide you the information you need to know what entry type add.

Depending on your setup you will use something like the following:

yourdomain.org.             300     IN      CAA     0 issuewild "awstrust.com"

or 

yourdomain.org.             300     IN      CAA     0 issue "awstrust.com"
												


Generating SSL Certificate
Once you have added your root domain, an SSL certificate will automatically be generated. There is no additional cost for the SSL certificate.

Once you add your root domain and the certificate has been issued, the Custom Domain page will update with instructions.


Root Domain DNS Configuration
The steps for the DNS configuration will be vary somewhat depending on which provider your organization uses. While this is not complicated to set up, it usually requires the help of your IT services. Once the DNS record is created, the Type, Name, and Value fields form your 2Account will need to be applied to the record. Below is an example of the information a DNS record filled out with the information gathered from the 2Account Domain Management page.

Once the Type, Host/Name, and Value/Data fields have been saved in your 2Account, you can return to the Custom Domain page in your 2Account.


Root Domain Validation
We automatically poll and detect the existence of the root domain record in your DNS. Once the record is added and confirmed by our system, the feature that allows you to add a subdomain will become available. If you do not see this, please double check the DNS record configuration. 


Add Subdomain
Now you can add a subdomain. Keep it simple, short, and sweet! 


Subdomain Type Dropdown
Select the type that applies to what you'll be using this subdomain for. The type dropdown contains 3 options:

  • Donate2 | Stream2 | Flex2 - used for Forms
  • Stream2 Beacon - Authorize - used for Brightcove Beacon web based login 
  • Stream2 Beacon - Activate - used for Brightcove Beacon device flow

The only time you will need to change this from the default option of Donate2 | Stream2 | Flex2 is if you are using our Brightcove Beacon OTT integration with your subdomain. 

Once you add your subdomain configuration, it will display on your Custom Domain page.


Subdomain DNS Configuration
The same steps will need to be taken to configure the subdomain DNS record that were taken for the root domain. Below is an example of what the DNS record looks like when it has both the root and one subdomain. 

If you are using AWS Route 53 you are required to add an A record type (with Alias) instead of a CNAME.


Subdomain Validation
We automatically look for the existence of the subdomain CNAME in your DNS. When it is available, we will validate and update your 2Account with a green check mark. Once it appears, it is ready to use with a form. 

These steps will need to be completed for any additional subdomains you want. 


Using Custom Domains with a Form
In the Form Setting collapsible in on a Form there are fields for adjusting the:

  • Custom Domain - Where you choose the configured subdomain you want to use 
  • Form Alias - Where you enter replacement characters for the 6 digit form code


Custom Domain Drop Down
This drop down will display any configured subdomains. Select the subdomain that you want to use for the form. The Form Alias and the Form Link sections in the editor will update to reflect the subdomain selected here.


Form Alias Field
You can also add a custom form alias to replace the 6 digit code that are assigned to forms form an even more personalized and memorable URL.


Form Link
The Form Link will always display the best URL to use. This URL reflects any Custom Domain or Form Alias settings that are selected. You can either copy the link to use in your marketing or pop open the form and grab the URL from there. 


Digital Wallets
We did the heavy lifting to make sure that Google Pay and ApplePay are able to work as a payment method with custom domains. There are no additional steps your organization needs to include this. If the patron's device is compatible with either Google Pay or ApplePay and they have it set up on their device, the option will automatically display when the patron loads the form. 


Google Pay


Apple Pay