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

# Themes

> A theme is the look of a design: colours, type, shape and spacing. How themes, designs and blocks inherit from each other.

A theme holds the look of a signature. Content (which blocks, what they say) lives in the design;
the theme decides how it looks. Open the **Theme** tab in the design editor.

## How inheritance works

Every value is settled in three steps, and the last one wins:

1. **Theme**: the base look. Pick one of Swashmo's themes or your own. Your workspace also has a
   **brand theme**, which follows the colours and font in your [brand kit](https://docs.swashmo.com/signatures/brand-kit.md).
2. **Design**: changes you make in the Theme tab apply to this design only. The theme itself isn't
   touched.
3. **Block**: **Style of this block** changes one block. Everything you don't change follows
   the design and the theme.

Changing the theme keeps the changes you made below it.

### Dots and reset arrows

A field that differs from what it inherits shows a dot and a reset arrow. Click the arrow to put
that field back to the inherited value. Each group also has **Reset group**.

## Token groups

| Group | What you set |
| - | - |
| **Colour** | Primary, accent, text, muted, subtle and faint text, links, button text, divider, card background and border |
| **Type** | The font, and for the name, title, body and labels: size, weight, line height, letter spacing and letter case |
| **Shape** | Corners of the card, buttons, photo and logo; divider thickness and style |
| **Spacing** | Card padding, gap between blocks, gap inside a line, overall scale |
| **Photo** | Size, shape, filter and filter strength. See [Photos](https://docs.swashmo.com/signatures/photos.md) |
| **Surface** | None, Solid card, Outline, Tinted or Glass. See [Glass signatures](https://docs.swashmo.com/signatures/glass-signatures.md) |
| **Dark mode** | Background for animations, a light logo on dark backgrounds, text readable on light and dark |

A block's style offers the groups that make sense on one block; the Surface group is only in the
Theme tab.

## Web fonts

Every email app has the standard fonts. **Inter**, **Poppins**, **Playfair Display** and
**Montserrat** are marked "(Apple Mail only)": they show in Apple Mail, and other email apps use a
similar standard font. Pick a standard font if you want the same look everywhere.

## Edit a theme used by several designs

When you change a theme's values in a design, you changed that design only. To keep the changes in
the theme, click **Keep these changes in the theme**. Swashmo shows how many designs and templates
use it, then offers:

* **Update all**: every design and template on the theme changes too, and their images render
  again.
* **Save as new theme**: keeps the changes as a theme of your own and leaves the original alone.

Swashmo's own themes can't be changed: your changes are saved as a theme of your own. If it is
your brand theme, the brand kit's colours and font change with it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.