Branding

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:

  1. Log into your KWS Control Panel, and then select the app that you want to apply your custom assets to.
  2. 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 elementValue
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 elementValue
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 elementValue
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 elementValue
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 headeryes/no
Your company’s support email addressA 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:

  1. Create a DNS CNAME record for the domain name you wish to use. For example, parents.mycompany.com
  2. Point it at the default URL for your Parent Portal, which looks something like this: mycompany.parents.kws.superawesome.tv
  3. 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:

Data retention policy – reminder email to parent
Forgotten password – email to parent – user password reset link
Forgotten password – email to parent – anonymous user password reset link
Forgotten password – email to user – user password reset link
Forgotten password – email to anonymous user – password reset link
Identity verification request
All in one – mobile – email to parent – opt-in permission
All in one – mobile – email to parent – multiple opt-in permission
All in one – mobile – email to parent – mixed permission
All in one – mobile – email to parent – opt-out permission
All in one – mobile – email to parent – opt-out permission anonymous child
App activation – email to parent – no permission
App activation – email to parent – no permission anonymous child
Opt-out notification – email to parent
Opt-out notification – email to parent – anonymous child
Permission request – email to parent – one permission
Permission request – email to parent – one permission anonymous child
Permission review – email to parent – one permission
Permission review – email to parent – one permission anonymous
Successful verification confirmation U.S. – email to parent
Successful verification confirmation non-U.S. – email to parent
Permission change confirmation – email to parent
Parent Portal login link – email to parent
Inactive child account – email to parent – 10 days notice
Inactive child account – email to child – 10 days notice
Inactive child account – email to parent – 1 day notice
Inactive child account – email to child – 1 day notice
Updated on 30/11/2020

Was this article helpful?

Related Articles