> 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/features/reports/report-themes.md).

# Report themes

A report theme controls how your exported reports look — cover page, fonts, chart colors, body text style, slide layouts. Themes apply at the project level (every new report uses the project default) and can be overridden per-report.

> **\[Screenshot needed]** Report Theme settings page with a custom theme uploaded, preview panel on the right showing a cover slide.

### Two ways to set a theme

#### Option A — Upload a PowerPoint template (recommended)

1. Build (or use) a `.pptx` template in PowerPoint with:
   * Your brand cover slide
   * Title-only, title + content, and section-divider layouts
   * Color scheme set in Slide Master
   * Default fonts and chart styles
2. Go to **Settings → Report Theme**.
3. Click **Upload template**, select your `.pptx`.
4. SMAQ extracts:
   * Color palette (primary, secondary, accent)
   * Fonts (heading, body)
   * Logo from the cover slide
   * Slide layouts
5. Save.

> **\[Screen video needed]** Uploading a custom .pptx template and watching SMAQ extract colors/fonts/layouts into the theme preview. \~60 seconds.

The advantage: your branding is consistent with the existing PowerPoint templates your team already uses elsewhere.

#### Option B — Pick from built-in themes

If you don't have a template:

1. **Settings → Report Theme**.
2. Pick from the built-in theme list.
3. Optionally customize the primary/secondary colors with the color pickers.
4. Save.

### Per-report theme override

You can switch themes for a single report without changing the project default:

1. Open the report.
2. Click **Theme** in the report header.
3. Pick a different theme (built-in or any other uploaded template).
4. Apply.

Useful when one client needs a different look from your project's default.

### What gets themed

* Cover slide layout and content
* Heading and body text fonts + sizes
* Chart color palette (line, bar, etc.)
* Table styles (header rows, alternating row colors)
* Section divider slides
* Footer / page number style

### What doesn't get themed

* Image content (SMAQ doesn't replace images in your template — you control those).
* Slide-specific custom layouts unique to your template (SMAQ supports the standard layout set).
* Animations or transitions.

### Tips

* **Test your template before relying on it.** Generate a report immediately after upload — confirm fonts render, colors apply, and the cover slide looks right.
* **Use Slide Master colors.** SMAQ extracts from Slide Master. If you've manually colored individual shapes, extraction may miss those.
* **Keep the template simple.** Three colors, two fonts, four layouts — enough for most decks.

### Troubleshooting

* **Fonts wrong after upload** — SMAQ falls back to web-safe fonts if your template uses fonts that aren't available. Use system fonts (Arial, Calibri, Inter, Roboto, etc.) for portability.
* **Colors look off** — SMAQ extracts theme colors only, not direct shape fills. Define your palette in Slide Master → Color Theme.

### Related

* [Reports overview](/documentation/features/reports.md).
* [Generate report from dashboard](/documentation/features/reports/generate-from-dashboard.md).


---

# 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/features/reports/report-themes.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.