# Branding

📝

Brand themes let admins define reusable colours and styling defaults for Capable formatting macros in Confluence.

A theme can include brand colours plus optional defaults such as corners, shadows, spacing, alignment, and borders.

### What does it do?

* Keeps macros visually consistent across pages.
* Applies a default theme to new macros, if one is set.
* Lets authors switch a supported macro to another theme without rewriting content.
* Shows approved brand swatches first in macro colour pickers.
* Select a theme to match when generating AI content.

ℹ️

Editing, changing, or deleting a theme does not update existing macros. Existing pages keep the colours and styling already saved in each macro.

![image-20260726-203400.png](https://help.gocapable.com/images/93d7cd73-0301-46a4-9609-5170bb13a53f.webp)

Apply a theme to a macro

![image-20260726-203500.png](https://help.gocapable.com/images/c2a1f178-8a2d-4f1f-899a-9fdeaed65f32.webp)

Apply a theme to Capable Studio output

### How do you set it up?

1. Open the **Capable** app in Confluence.
2. Go to **Global settings → Formatting → Brand guidelines**.
3. Click **Add theme**.
4. Name the theme and set the five colours: **Background**, **Text on background**, **Surface**, **Text**, and **Accent**.
5. Optionally set styling defaults, or leave them on **Auto**.
6. Choose whether this should be the **default** theme for new macros.
7. Set **Allow custom colours** on or off, depending on whether authors can use colours outside the theme.
8. Click **Save**.

![image-20260726-203238.png](https://help.gocapable.com/images/1f3483ea-f831-4e24-8725-138443e41a98.webp)

### Using a theme

Authors can open a supported macro, click **Themes**, preview a theme, and apply it. Only the look changes - the macro content stays the same.

You can create up to **8 themes** per organisation. Only Confluence admins can create or edit them.