> ## Documentation Index
> Fetch the complete documentation index at: https://docs.p2p.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Theme Customization

> Theme customization options for the P2P.org Widget, covering colors, branding, typography, and runtime theme switching

export const WidgetHeaderLinks = () => <CardGroup cols={2}>
    <Card title="Widget Demo" icon="play" href="https://demo.widget.p2p.org" horizontal />
    <Card title="Live Example" icon="link" href="https://widget.p2p.org/" horizontal />
  </CardGroup>;

<WidgetHeaderLinks />

The P2P.org Widget supports comprehensive theming to match your brand and provide a consistent user experience across your platform.

<img src="https://mintcdn.com/p2p0rg/TVjPps9rHpP3Dmwq/images/docs/theming_preview.png?fit=max&auto=format&n=TVjPps9rHpP3Dmwq&q=85&s=55341ca3603f7a20e00240cfe6c6eb63" alt="Theming Switching Preview" width="1938" height="1712" data-path="images/docs/theming_preview.png" />

Each widget integration can be customized to match your brand identity through:

* 🎨 **Colors** – Primary, secondary, background, and accent colors
* 🖼️ **Branding** – Logo, favicon, and brand elements
* 🔤 **Typography** – Fonts and text styles
* 🌓 **Theme Modes** – Light, dark, or auto-switching themes
* 📐 **Layout** – Spacing and component arrangements

## Runtime theme switching (iframe / postMessage)

See [Platform Integration Examples](./widget-platform-integration.mdx#sending-events-from-host-to-widget-postmessage) for the canonical `postMessage` snippet and security notes.

## Live Demo Stand

Check [live demo stand](https://demo.widget.p2p.org/), where you can try different settings, colors, layout, see mocked positions, history data and more.

## FAQ

### Can I use my custom font?

Yes, if it's web-hosted and you have proper licensing. Provide font file URLs or CDN links.

### Do theme changes affect existing users?

Yes, theme updates apply to all users immediately.

### Can different user segments have different themes?

Not within the same widget URL. You would need separate widget deployments for segment-specific themes.

### What if my brand colors don't have enough contrast?

We can work with you to find acceptable variations that maintain brand recognition while meeting accessibility standards.

### Can I change themes after launch?

Yes, themes can be updated anytime. Minor changes take a few days, major redesigns take 2-4 weeks.

***

<Note>
  For help with theme design or to request customization [contact the P2P.org team](https://support.p2p.org)
</Note>


## Related topics

- [Quick Start](/docs/widget-quick-start.md)
- [Platform Integration Examples](/docs/widget-platform-integration.md)
- [Integration Planning Guide](/docs/planning-considerations.md)
- [Overview](/docs/overview.md)