> 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

Style your exported reports with custom colors, fonts, logos, and slide layouts. Upload a PowerPoint template and SMAQ extracts everything automatically.

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).