> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go.gbgplc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create journey themes

> Create and edit journey themes in GBG Go to control the colours, corners, logo, and text styles applied to your hosted journey screens.

A [journey theme](/docs/go-v2/get-started/key-concepts#journey-themes) 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](/docs/go-v2/platform/branding).

<Note>
  Journey themes apply to hosted journeys only, in both Low-code and No-code delivery. An API-first integration renders its own screens, so it doesn't use a journey theme.

  Changes to a theme apply to every journey that uses it, though they can take a few minutes to reach journeys that are already running. Create a new theme instead of editing an existing one when you want to brand a single journey differently.
</Note>

## 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](/docs/go-v2/platform/branding#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**.

<Tip>
  Check the contrast between your **Text** and **Background** colours, and between your **Button text** and **Primary** colours. Low contrast makes screens hard to read for customers with low vision.
</Tip>

### 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**.

<Note>
  You choose from the fonts built into the GBG Go platform. You can't upload or import your own font files.
</Note>

## 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.

<Warning>
  Editing a theme changes every journey that uses it, including journeys already published to production. Create a separate theme when you want to change the branding of one journey only.
</Warning>

## 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](/docs/go-v2/platform/audit-log).

## Next steps

<Card title="Branding" icon="paintbrush" href="/docs/go-v2/platform/branding">
  Apply a theme to a hosted journey and preview it before you launch.
</Card>