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