> For the complete documentation index, see [llms.txt](https://everyday-digital.gitbook.io/publishing-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://everyday-digital.gitbook.io/publishing-docs/publishing-options/theme-and-assets.md).

# Theme & Assets

## What is Theme & Assets?

**Theme & Assets will be displayed on the** [**Listing**](/publishing-docs/publishing-options/listing.md)**.** The colour scheme is determined by the Theme, while the Assets consist of the added media.

## Theme

**Your platform comes with a preset Theme.** You can customise your Theme or choose from the Available Themes. To modify your Custom Theme, choose a Primary Colour and Accent Colour. 

### **Quick Steps: Editing your Theme**

1. **Open your content (Authoring, Streams, Pathways).** 
2. **Open Theme & Assets.** Select the Edit icon to adjust your Theme.
3. **Choose a Theme.** Choose from an Available Theme, or choose your Custom Theme. If required, select Primary and Accent colours to adjust your Custom Theme.

##

## Content Icons: Primary Icon  & Alternative Icon

**Your icon is the first visual hint of what your content is about.** Upload an icon from your personal collection, or use the platform's [Marketplace](https://everyday-digital.gitbook.io/template-catalog/) to source a quality, free stock image courtesy of an Unsplash.com integration.

### Icon Sizes

**The icons must be a .png or .jpeg image at least 1024 x 1024 px in size.** Images bigger than the minimum will simply be auto-resized.

**Primary icons are required; alternative icons are optional.** To differentiate the icon in the featured content banner from the one in the listing, feel free to upload an alternative icon. However, uploading a primary icon is the only requirement.

{% hint style="info" %}
When [**adding podcast and YouTube streams**](broken://pages/-MB9H6zjTXHX1cnBIFQL), the listing will be **auto-populated** with assets from the original source.
{% endhint %}

## Custom Theme Options

### Custom Level Colours (Pathways only)

**Custom Level Colours apply activities in a level**. You can choose a custom colour (Recommended, Theme, Vibrant or Pastel) for each [Pathway Level](https://everyday-digital.gitbook.io/pathways-docs/pathway-editor/create-a-pathway#what-are-pathway-levels). 

**Level colours overwrite the Pathway/App theme and are applied to:**

* Activity icons
* Pathway tiles

### Use Custom Theme (Pathways & Authoring)

**To change the theme for a** [**Pathway**](https://everyday-digital.gitbook.io/pathways-docs/) **or for** [**Learning Content**](https://everyday-digital.gitbook.io/authoring-docs/authoring/content-types/learning-story)**, open Themes and Assets and select custom colours under Use Custom Theme.** 

{% hint style="info" %}
**Custom Pathway themes change the app UI.** This ensures consistent visual queues in both the Pathway/learning story and the app; it avoids theme conflicts between the app theme and content theme.
{% endhint %}

###  Theme Fonts (Authoring only)

{% hint style="warning" %}
This option is only available in the Theme & Assets for [Authoring](https://everyday-digital.gitbook.io/authoring-docs/).
{% endhint %}

**For Custom Themes, you can change the font that is used**. Select the down arrow to choose from the available fonts.

## Theme & Assets FAQ

### What are Recommended Colours?

**When you upload an Icon Asset to your Listing, recommended colours will be added to your custom theme options.** These recommendations are based on colours detected in the image(s) you have added. This assist in selecting colours that harmonise with the provided assets. 

### Why can't I choose my own colours?

**Custom, brand-specific colours are added to your Custom Theme when your platform app and account are set up.** Custom options are limited to retina-screen compatible colours (vibrant, pastels, theme, and recommended colours).

### Icons: Best Practice

If you don't use [Marketplace](https://everyday-digital.gitbook.io/template-catalog/) to find icon images, you can also design your own icon.

#### Good Icon Examples

<figure><img src="/files/gdkHhl8Iw5iS1nYL57go" alt=""><figcaption><p>Simple, clear, relevant</p></figcaption></figure>

**Bad Icon Examples**

<figure><img src="/files/iQ7oZn1e5tT9lRMoy48u" alt=""><figcaption><p>Too white, pixelated, bad contrast, distorted icon, illegible text</p></figcaption></figure>

### My custom font is not working

Custom fonts can only be applied if you have selected the Custom Theme.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://everyday-digital.gitbook.io/publishing-docs/publishing-options/theme-and-assets.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.