> For the complete documentation index, see [llms.txt](https://docs.smaq.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smaq.io/documentation/projects/project-settings/project-theme.md).

# Project theme

Brand your dashboards with custom colors, fonts, and a logo. Project themes apply to the in-app dashboard view and public dashboard shares.

The project theme controls how dashboards look — colors, fonts, the logo shown at the top of public dashboard shares. Separate from the [report theme](/documentation/projects/project-settings/report-theme.md), which styles exported .pptx reports.

> **\[Screenshot needed]** Project Theme settings tab with primary/secondary color pickers, font dropdowns, logo upload field, and a live preview panel.

### What you can customize

* **Logo** — shown at the top of public dashboard URLs and in the dashboard header for the in-app view. Upload PNG or SVG (PNG ≤ 1MB).
* **Primary color** — accent color used in charts, buttons, links.
* **Secondary color** — supporting accent.
* **Background color** — dashboard canvas background.
* **Font family** — heading and body font.

### Setting the theme

1. **Settings → Project Theme**.
2. Edit the fields.
3. The preview panel updates live.
4. **Save** when you're happy.

> **\[Screen video needed]** Setting up a project theme — uploading a logo, changing colors, watching the preview update, saving. \~60 seconds.

### Where the theme shows up

* **In-app dashboards** — every dashboard in this project uses the theme.
* **Public dashboard links** — same theme, with logo prominently displayed at the top.
* **Snapshots** — frozen with whatever theme was active when the snapshot was saved.
* **Dashboard Summary emails** — partial use; basic color theme inherited.

### What it doesn't affect

* **Reports** — see [report theme](/documentation/projects/project-settings/report-theme.md) for those.
* **Automation emails (Daily Brief, etc.)** — these use a standard SMAQ template.
* **Chat panel** — uses SMAQ's default UI styling for consistency.

### Tips

* **Use brand-safe colors.** A neon green primary might look great on your brand site but unreadable in a dashboard chart. Stick to mid-saturation colors.
* **Test on a real dashboard.** Open a multi-chart dashboard after saving and check that everything reads cleanly.
* **Logo file size matters.** Public dashboards load the logo on every page view. Keep it under 100KB if possible.

### Related

* [Report theme](/documentation/projects/project-settings/report-theme.md) — for .pptx exports.
* [Public dashboards & sharing](/documentation/features/dashboard/public-share-and-chat.md) — where the logo is most prominently displayed.