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

# Customize

> Describe how your workspace's charts and canvases should look, and Upsolve designs the theme they are drawn in, everywhere your agent answers.

**Customize** sets the look of everything your workspace's agent draws: its charts, its canvases and the reports its rules send. Open it from **Test & Ship → Customize** in the workspace sidebar.

There are no colour pickers. You describe the look you want, in words, with your website, logo and reference files to help, and **Design** turns that brief into a complete theme in about 15 seconds.

![The Customize page with the design brief on the left (website, logo, design prompt, reference files) and the theme preview with sample charts on the right](https://mintcdn.com/upsolve/Nurc8hPkBODmwDS1/images/ai-agent-builder/workspaces/customize.png?fit=max\&auto=format\&n=Nurc8hPkBODmwDS1\&q=85\&s=dafbd82e039fa5f71290e750c604eaba)

## Write the brief

The left side of the page is the brief the theme is made from:

* **Website**: enter your brand's site and click **Scan and apply**. Upsolve reads its colours and fonts and adds them to the prompt as hex codes.
* **Logo**: drop your logo (PNG, JPEG, WebP or SVG, up to 8 MB). It's shown in chart headers and canvases, and scanning it adds its colours to the prompt.
* **Design prompt**: everything the design comes from. Say which colours to use (as hex codes), light or dark, the typeface, the tone and how dense the charts should feel. You can edit what the website and logo scans added.
* **Files and context**: drop reference files such as a brand guide, a CSS file or screenshots. Each text file is read up to its first 24,000 characters, and all text files together contribute at most 24,000 characters, in the order you added them, so put the most important guidance first. Images only contribute their colours.

Then click **Design**.

## Preview the theme

Click **Show preview** to see the result: whether the theme is light or dark, its font, its primary, accent and brand colours, and sample charts drawn in it. Below the charts:

* **Style guide**: the rules the theme follows, in words.
* **History**: every design you have made. Click **Apply** on any of them to go back to it.
* **How canvas designs use it**: how canvases pick up the theme.

If you change the brief after designing, the preview tells you it's out of date. Click **Design** again to update it.

## Save it

The theme is part of the workspace, versioned with everything else:

1. **Save** keeps your changes in the workspace's draft. **Reset** throws away unsaved changes.
2. The theme reaches your users when you **save a version** and promote it, like any other change. See [Workspaces: Draft, Publish and Production](https://docs.upsolve.ai/ai-agent-builder/workspaces.md#draft-publish-and-production).

Open a saved version and its theme is shown read-only, with **Edit the draft** to go back to editing. The trash icon clears the design, the prompt and the logo, and returns the workspace to the default look; nothing else in the workspace changes.

## Where the theme appears

One theme is used everywhere the workspace draws a chart:

* Charts in the Playground (using the version you're chatting with) and in Home.
* Your embedded chat and the end-user workspace (using the version in production).
* Canvases and their designs.
* PDF reports and images sent by [Rules & Actions](https://docs.upsolve.ai/ai-agent-builder/interact/rules-and-actions.md).
* Chart images in [Upsolve for Slack](https://docs.upsolve.ai/slack/overview.md).
* Chart widgets in [Claude and other MCP clients](https://docs.upsolve.ai/ai-agent-builder/deploy-agents/mcp-server.md).

A workspace embed can still choose light or dark with the `theme` URL parameter; see [Embed Upsolve in your product](https://docs.upsolve.ai/embedding.md).

## Next steps

> [card] [Embed Upsolve in your product](https://docs.upsolve.ai/embedding.md)
>
> Put your themed agent in front of your users.

> [card] [Canvas](https://docs.upsolve.ai/ai-agent-builder/interact/canvas.md)
>
> Boards of charts drawn in your theme.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.