Create journey themes

A journey theme controls how your hosted journey screens look to your customers. It holds the colours, corner styles, logo, and text styles that the GBG Go platform applies to the screens your customers see. You create and edit themes in Settings. You then apply a theme to an individual journey in the Journey builder. To learn how, see Branding.

​

Default theme

Every organisation starts with a Default theme. The Default theme uses GBG colours and the DM Sans font, and it has no logo. You can edit the Default theme, and you can create as many other themes as you need. Each theme has its own resource ID and version, shown above the Branding and Text styles tabs. Developers use these values to reference the theme when they start a journey through the API. To learn how, see Apply a theme through the API.

​

Create a theme

To create a journey theme:

1. In the GBG Go platform, click Settings.
2. Click the Journey Themes tab.
3. Click Create a new theme.
4. Enter a name for your theme, for example, “Retail onboarding theme.”
5. Click Create new theme.

Your theme is created with the default values, and it is selected in the theme list. The GBG Go platform saves the theme as soon as you create it, so you don’t need to save it before you configure it.

​

Configure branding

The Branding tab holds the colours, corner styles, and logo for your theme. To configure the branding of a theme:

1. In the GBG Go platform, click Settings.
2. Click the Journey Themes tab.
3. Select your theme from the theme list.
4. Click the Branding tab.
5. Under Colours, enter a six-character hex value for each of the following, or click the colour swatch to pick a colour:

   Colour	What it applies to
   Primary	Buttons and other primary elements.
   Background	The background of each screen.
   Text	Body text and headings.
   Input text	Text your customer enters in a field.
   Input background	The background of an input field.
   Input border	The border around an input field.
   Input placeholder text	Hint text shown in an empty input field.
   Disabled input background	The background of an input field your customer can’t edit.
   Button text	Text on buttons.

6. Under Rounded corners, enter a value in pixels for the following:
   • Input corners: The corner radius of input fields.
   • Button corners: The corner radius of buttons.
7. Under Logo, click Upload new logo and select your logo file.
8. Click Save, then click Save changes.

​

Logo requirements

Your logo must meet the following requirements:

• The file format is PNG or SVG.
• The file size is 5 MB or smaller.

Larger logos shrink to fit the space available on the screen. The logo is optional, so leave it empty if you don’t want a logo on your journey screens.

​

Configure text styles

The Text styles tab holds the font, size, line height, and weight for the text on your journey screens. To configure the text styles of a theme:

1. In the GBG Go platform, click Settings.
2. Click the Journey Themes tab.
3. Select your theme from the theme list.
4. Click the Text styles tab.
5. Under Headings, select a font from the Heading font list.
6. Click Heading level 1, then set the following:
   • Size: The font size in pixels.
   • Line height: The space between lines, as a percentage of the font size.
   • Weight: The thickness of the text.
7. Click Heading level 2 and set the same values for your second-level headings.
8. Under Text, select a font from the Text font list.
9. Click each of the following tabs in turn, and set the size, line height, and weight for each:
   • Normal text: Body text on your journey screens.
   • Small text: Supporting text, such as hints and helper text.
   • Forms: Text in form fields and their labels.
10. Click Save, then click Save changes.

​

Edit a theme

You edit a theme in the same tabs you use to configure a new one. The Save button becomes available once you make a change. To edit a theme:

1. In the GBG Go platform, click Settings.
2. Click the Journey Themes tab.
3. Select the theme you want to edit from the theme list.
4. Change the values on the Branding tab, the Text styles tab, or both.
5. Click Save. A confirmation message tells you that your changes apply instantly to journeys using this theme.
6. Click Save changes.

If you don’t want to apply your changes, then click Cancel in the confirmation message.

​

Rename a theme

To rename a theme:

1. In the GBG Go platform, click Settings.
2. Click the Journey Themes tab.
3. Select the theme you want to rename from the theme list.
4. Click Rename.
5. Enter the new name and confirm it.

Renaming a theme doesn’t change its resource ID, so journeys that use the theme are unaffected.

​

Audit logging

The GBG Go platform records the following theme activity in the audit log:

• Creating a theme.
• Editing a theme.
• Applying a theme to a journey.

To review this activity, see Audit log.

​

Next steps