Sub Domain Option
The standard url web address for your Brandkit site is http://your-account-shortname.brandkit.io (e.g. acme.brandkit.io)
However if you want to use a custom URL, using a subdomain of your primary web address for example, such as images.acme.com, you will need to update your DNS (Domain Name System) record for your registered domain.
Example Site URLs:
Step 1: Add a CNAME record to your DNS
Typically you'll need someone in IT or your Domain service provider to do this for you.
- First choose a Hostname (subdomain) that you want your users to type into their browser address bars e.g. images becomes images.acme.com
- You will need your original Brandkit Account URL (e.g. acme.brandkit.io). You'll use this for the CNAME VALUE below.
- Then add the Hostname and CNAME record to the DNS record for your primary domain, that points to your Brandkit Account URL (contact email@example.com if you are unsure what this is). It should look something similar to the example below.
Example shown below for: images.acme.com
Step 2: Advise Brandkit Support
Once the CNAME is setup, you'll need to advise firstname.lastname@example.org that you have setup a CNAME and exactly what your new URL will be (e.g images.acme.com).
Brandkit staff will then configure your Brandkit account to use the URL for your account, and start the SSL Certification process. This may take a day or two.
Step 3: Publicise the your new site address
Once propagation of your DNS changes and the setup of a secure SSL Certificate on your new address is completed, Brandkit Support will let you know.
You can then start using the new URL and inviting your users to use the new URL.
We recommend you test the new URL yourself before inviting others to use it.
Note: Your original Brandkit URL (e.g. acme.brandkit.io) will continue to work - but when you hit the site the address bar in your browser will be redirected to your primary/preferred URL (e.g. images.acme.com).
Customers Note: Once you have edited your DNS record you must advise email@example.com and include your full subdomain address so that we can configure your account to use this custom url. Only once we do this can you test that it is working correctly.
Brandkit System Admins only: You must add the Customer's provided subdomain url in full to the Heroku Domains settings for Brandkit (production) and into the Hosts panel in System Admin. Then test after allowing for DNS propagation.
Root Domain Option
It's also possible to use a completely new domain name (rather than a subdomain of an existing domain as above) for example acmebrand.com.
However it's a little trickier to setup.
This is because (we're going to get technical here) we don't support IP addresses for the Root A record.
Instead CNAME must be used, dictated to us by Heroku (our cloud infrastructure provider) an also good modern security practice.
Please refer to this article if you want to setup a Root Domain for your Brandkit account.
Alternatively the simplest approach is to use Web Forwarding.
- Add a subdomain to your primary domain name as per Sub Domain instructions above. (e.g. images.acme.com)
- Register a new domain name (e.g. acmeimages.com)
- Setup web forwarding (on the new domain) to forward from your new domain to the sub-domain setup in step 1. ( e.g. acmeimages.com is forwarded to images.acme.com).
Most Domain Registries support web forwarding (aka web forwarding, URL redirect, web redirect, 301 redirect, etc).
The Brandkit system sends a number of emails on your behalf. Some emails are triggered by system events and some are triggered by Admin users.
In both cases the default from email address is firstname.lastname@example.org.
We can configure the FROM address used in these emails, so that (a) the user can see that email is from your account rather than from Brandkit and (b) so that the user can reply to the email and have the email reach your configured email address.
A typical From email address would be: email@example.com
While Brandkit support will configure your from email address in the account settings, you will need to add a TXT record to your DNS (Domain Name System) record for the domain name specified in your Email From address.
For email add a new TXT record as follows
Note: If you already have an SPF record set, you should ADD this to the current record:
'include:mailing.brandkit.io’, before any ‘~all’/
when: 'v=spf1 a mx include:_spf.google.com include:mailchimp.com’
then: 'v=spf1 a mx include:_spf.google.com include:mailchimp.com include:mailing.brandkit.io’
Note NZ Gov only:
In New Zealand the Department of Internal affairs has mandated that NZ Gov departments do not accept this standard approach to dealing with renamed From addresses sent on behalf of NZ Government departments. Therefore if you are an NZ Govt department you will not be able to change a branded from address.