> 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

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.


---

# 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:

```
GET https://docs.smaq.io/documentation/projects/project-settings/project-theme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.