Key to customising KWS to fit into your corporate identity is branding the SSO view, the Parent Portal, and the emails that KWS sends to users and their parents.
Most branding in KWS requires you to supply the custom assets to your Implementation Manager, who will apply them to your KWS environment for you. However, you can apply some branding assets yourself in the Control Panel. See the following sections for details.
The Branding view
The Control Panel’s Branding view enables you to upload some branding assets yourself, while others must be uploaded for you by your Implementation Manager. To access the Branding view:
- Log into your KWS Control Panel, and then select the app that you want to apply your custom assets to.
- Click Settings > Branding.
Localise your branding
You can localise the assets that you upload in the Branding view. For example, to upload custom assets for your French-speaking users, select ‘French’ from the dropdown menu on the right-hand side, and then upload your assets as usual:
Contact your Implementation Manager if you need to localise any additional branding items.
Brand the SSO view
You can customise the KWS SSO view to make it consistent with the look and feel of your app. These are the SSO branding assets you can upload yourself in the Branding view:
| Branding element | Value |
|---|---|
| App logo to be displayed in the SSO view. See (B) in the SSO image below. | .png |
| Favicon to be displayed in the SSO view and on its browser tab. | .png |
Ask your Implementation Manager to upload your custom assets for these additional SSO branding items:
| Branding element | Value |
|---|---|
| Secondary colour. See (A) below. | Hex/RGB Colour Code |
| Primary colour. See (D) below. | Hex/RGB Colour Code |
| The URL for your privacy policy. See (C) below. | URL (HTTPS) |
Brand the Parent Portal
These are the Parent Portal branding assets you can upload yourself in the Branding view:
| Branding element | Value |
|---|---|
| Your app icon to be displayed in the Parent Portal. | .png 540 x 540 pixels |
| The email footer to be displayed in all automated emails to parents. | This can include Markdown; for example, to embed clickable links. |
Ask your Implementation Manager to upload your custom assets for these additional Parent Portal branding items:
| Branding element | Value |
|---|---|
| The Parent Portal logo, displayed in the header of the Parent Portal. See (A) below. | .png |
| The background image for the Parent Portal login page and password reset page. See (B) below. | .png 1300 x 500 pixels |
| Colour of Parent Portal ‘call to action’ (CTA) buttons. For example, ‘sign-in’ and ‘send a login link’ buttons. This setting also determines the background colour of the permission copy in Parent Portal emails. See (C) below. | Hex code e.g. F10020 |
| URLs for: – Your ‘About Us’ page – Your ‘Contact Us’ page – Your ‘FAQs’ page – Your privacy policy – Your terms and conditions See (D) below. | URLs (HTTPS) |
| The banner image to be used as the header for emails sent from the Parent Portal | .jpg 620 x 225 pixels |
| The image to be used as the favicon for the Parent Portal | .png 32 x 32 pixels |
| Transparent Parent Portal header | yes/no |
| Your company’s support email address | A valid email address |
Brand the Parent Portal domain name
You can brand the Parent Portal domain name by changing the default domain to your own custom name. To do this:
- Create a DNS CNAME record for the domain name you wish to use. For example,
parents.mycompany.com - Point it at the default URL for your Parent Portal, which looks something like this:
mycompany.parents.kws.superawesome.tv - Let us know when you’ve done this and we will take care of the rest.
Brand your Parent Portal sender email address
You can brand the sender email address that is shown in all emails sent by KWS. For example, you might wish all KWS emails to use a sender email address such as:
noreply@mycompany.com
To change your KWS sender email address, add the following SPF and DKIM DNS records to the domain you wish to use:
SPF Record
v=spf1 include:spf.mandrillapp.com ?all
If you already have a TXT record with SPF information, you need to add Mandrill’s servers to that record by adding include:spf.mandrillapp.com
to the record before the last operator, which is usually ?all, ~all, or -all.
DKIM Record
Add a new TXT record with the name:
mandrill._domainkey.yourdomain.com
where ‘yourdomain.com’ is the domain you’re setting up.
The content of this record should be set as below:
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrLHiExVd55zd/IQ/J /mRwSRMAocV /hMB3jXwaHH36d9NaVynQFYV8NaWi69c1veUtRzGt7yAioXqLj7Z4TeEUoOLgrKsn8YnckGs9i3 B3tVFB+Ch/4mPhXWiNfNdynHWBcPcbJ8kjEQ2U8y78dHZj1YeRXXVvWob2OaKynO8/lQIDAQAB;
Some DNS providers require ; to be escaped using \ characters. If this is the case, use the following:
v=DKIM1\; k=rsa\; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrLHiExVd55zd/IQ/J /mRwSRMAocV /hMB3jXwaHH36d9NaVynQFYV8NaWi69c1veUtRzGt7yAioXqLj7Z4TeEUoOLgrKsn8YnckGs9i3 B3tVFB+Ch/4mPhXWiNfNdynHWBcPcbJ8kjEQ2U8y78dHZj1YeRXXVvWob2OaKynO8 /lQIDAQAB\;
Once these records are set for your domain of choice, contact your Implementation Manager, who will confirm them before changing settings within your KWS instance.
Brand the KWS email copy
As described in Brand the Parent Portal above, you can provide a custom header image and email footer for the automated emails sent to parents and users by KWS.
In addition, you have the option to change the default email copy that is provided by KWS. Although the copy can be tailored to your requirements, we strongly recommend that you retain the standard copy that is provided. This text has been through our own legal review and is optimised for the best UX and conversion rates.
Standard email copy
You can review all the standard email copy in the following images:
