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.

Brand the Parent Portal

These are the Parent Portal branding assets you can upload yourself in the Branding view:

Branding assetDescription
App iconDisplayed in the Parent Portal.
.png
540 x 540 pixels
Email footer Displayed at the bottom of all automated emails to parents.

This can include Markdown. For example, you can embed clickable links.

Ask your Implementation Manager to upload your custom assets for these additional Parent Portal branding elements:

Branding elementDescriptionExamples
Background imageThe background image for the Parent Portal login page and password reset page.

Format: .png
1300 x 500 pixels
Email header imageThe banner image to be used as the header for emails sent from the Parent Portal.

Format: .jpg
620 x 225 pixels
FaviconThe image to be used as the favicon for the Parent Portal.

Format: .png
32 x 32 pixels
Parent Portal logoThe Parent Portal logo, displayed in the header of the Parent Portal.

Format: .png

Primary colour– The colour of the Parent Portal ‘call to action’ (CTA) buttons.
– The background colour of the permission copy in Parent Portal emails.

Format: Hex code
Example: F10020

Transparent Parent Portal headeryes/no
URLs for your company’s:
– ‘About Us’ page
– ‘Contact Us’ page
– ‘FAQs’ page
– Privacy policy
– Terms & conditions
URLs (HTTPS)
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

Brand the KWS SSO view

Applicable only if you are using KWS’ user account management service.

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 assetDescriptionExample
App logoThis is the logo that is displayed at the top of the KWS SSO view.

.png file
FaviconThis is the icon that is displayed on the KWS SSO view browser tab.

.png file

Ask your Implementation Manager to upload your custom assets for these additional SSO branding elements:

Branding elementDescriptionExample
Primary colourThis is the background colour for the KWS SSO view. The default is white.

Hex/RGB colour code
The URL for your privacy policyThe user is directed to this URL when they click the privacy policy link in the KWS SSO view.

The Branding view enables you to upload localised branding assets and email footers. See Localise your branding.

Updated on 29/04/2021

Was this article helpful?

Related Articles