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

# Workspace Branding

> Put your logo and company name on PDF exports and shared links, and your chart colors on PDFs and in-app artifacts, for one workspace.

Set branding once per workspace and every PDF export from that workspace carries your logo in the header, your company name in the footer, and your six-color palette on its charts. The same palette also colors charts in artifacts (the dashboards and reports agents generate) when you view them in the app.

## Prerequisites

| Requirement | Details |
| - | - |
| Plan | **Scale** or **Enterprise**. On Free or Team, the **Branding** tab shows an upgrade prompt instead of the editor. See [Pricing](https://docs.cloudthinker.io/guide/billing/pricing.md). |
| Role | **Admin** in the workspace. Organization Owners and Admins are Admin in every workspace. Developers and Viewers can open the tab but see the form disabled. |
| Logo file | PNG, JPEG, WebP, or SVG, 5 MB or smaller. A wide logo on a transparent background works best. |

## Set up branding

**1. Open the Branding tab**

In the sidebar, click **More → Workspace settings**, then select **Branding** under **Workspace** in the left menu. The **Chat Settings** gear in the chat box opens the same dialog.

The editor sits on the left. The right side shows a **PDF Export Preview** with sample data that updates as you edit, so you can check your work without exporting anything.

![Branding tab with logo, company name, and chart color fields on the left and a live PDF export preview on the right](https://mintcdn.com/cloudthinker/-4m9DUjwzDxHfABz/images/workspace-branding/05-branding-page-layout.png?fit=max\&auto=format\&n=-4m9DUjwzDxHfABz\&q=85\&s=93e6b6baca8142b02243e40a7d36d940)

**2. Upload your logo**

Drag a file onto the **Company Logo** area, or click **Upload Logo** and pick one. The logo appears on a checkerboard background so you can see whether transparency survived.

**Success state:** your logo shows in the editor and in the preview header, and a **Remove** button appears next to **Upload Logo**.

> [!NOTE]
>
> The logo saves as soon as the upload finishes, and **Remove** takes effect immediately too. **Save Brand Settings** only covers the company name and chart colors.

**3. Enter your company name**

Type it into **Company Name** (up to 255 characters). It replaces "CloudThinker" in the PDF footer, which then reads "Generated by Your Company".

**4. Pick your chart colors**

**Chart Colors** has six slots: **Primary**, **Secondary**, **Tertiary**, **Accent 1**, **Accent 2**, and **Accent 3**. For each one, click the swatch to use your system color picker, or type a hex code such as `#6366F1`.

If you only have one brand color, set **Primary** and leave the rest on the defaults. **Reset to defaults** puts all six back to the CloudThinker palette.

The preview's bar and pie charts each use all six colors, so you can check them side by side for contrast before you save.

**5. Save**

Once you change the name or a color, **Save Brand Settings** appears with an "Unsaved changes" note. Click it.

**Success state:** a "Workspace updated successfully" notification appears and the button disappears. If the save fails, your edits stay in the form so you can fix them and try again.

**6. Check a real export**

Open any report or dashboard and click **Download PDF** at the top of the page (it's also in the **More actions** (⋯) menu). Every page should show your logo in the header, your colors on the charts, and "Generated by Your Company" in the footer.

![A default CloudThinker PDF page next to the same page exported with a custom logo, company name, and chart palette](https://mintcdn.com/cloudthinker/-4m9DUjwzDxHfABz/images/workspace-branding/01-hero-before-after.png?fit=max\&auto=format\&n=-4m9DUjwzDxHfABz\&q=85\&s=bed262bf3c8e7f555d17874dcab7abd1)

To remove branding later, click **Remove** under the logo, clear **Company Name**, click **Reset to defaults**, and save.

## Choosing six colors

Charts use the slots in order: a chart with four series uses Primary through Accent 1, and a chart with more than six series starts again at Primary.

* Put your main brand color in **Primary**. Most single-series charts use only that slot.
* Vary the hue, not only the shade. Six blues make a multi-series chart hard to read.
* Avoid very pale colors in the first slots. PDFs render on white, and light bars or lines fade into the page. The default Accent 2 and Accent 3 are light, but only charts with five or more series reach them.
* Don't put red and green in neighboring slots. Readers with color blindness can't tell them apart.

The default palette, used by every workspace until you change it:

| Slot | Hex |
| - | - |
| Primary | `#0d9488` |
| Secondary | `#0369a1` |
| Tertiary | `#15803d` |
| Accent 1 | `#60a5fa` |
| Accent 2 | `#5eead4` |
| Accent 3 | `#86efac` |

## Reference

| Setting | Rules | Where it shows up |
| - | - | - |
| Logo | PNG, JPEG, WebP, or SVG, max 5 MB. The file contents must match its type. SVGs are sanitized, so scripts and unsafe attributes are stripped. Uploading a new logo replaces the old one. | PDF header and shared links |
| Company name | Plain text, max 255 characters. Defaults to "CloudThinker". | PDF footer and the shared link footer |
| Chart colors | Exactly six colors in `#RRGGBB` format. Three-digit shorthand like `#fff` is rejected. | Charts in PDF exports, and charts in artifacts viewed in the app |
| Shared links | No separate settings | Logo, plus a "Shared from Your Company" footer. See [sharing](https://docs.cloudthinker.io/guide/sharing.md#what-viewers-see) |

Branding belongs to one workspace. Each workspace in your organization can have its own logo, name, and palette. Charts elsewhere in the app, such as incident or Review analytics, always keep the CloudThinker palette. Branding doesn't apply to notifications or emails.

## Troubleshooting

> [accordion] The Branding tab shows an upgrade prompt
>
> Your organization is on a plan without branding. Click **Upgrade Plan** in the prompt, or see [Subscription](https://docs.cloudthinker.io/guide/billing/subscription.md).

> [accordion] The form is grayed out
>
> You have view-only access. A banner reads "You have view-only access to brand settings." Ask a workspace Admin to make the change, or to give you the Admin role. See [Workspace members](https://docs.cloudthinker.io/guide/workspace-users.md).

> [accordion] The upload is rejected
>
> "Unsupported file type" means the file isn't PNG, JPEG, WebP, or SVG, or its contents don't match its extension. "File too large" means it's over 5 MB. Re-export the logo from your design tool and try again.

> [accordion] The logo looks blurry or has a white box around it
>
> Blurry: the source image is too small. Export a wider PNG or use SVG. White box: the file has no transparency. Export a PNG with a transparent background, or an SVG. If an SVG looks different from your design tool, it probably relied on scripts or animation that sanitizing removed, so export a static PNG instead.

> [accordion] A PDF I downloaded earlier still has the old branding
>
> Expected. Each PDF uses the branding that was active when you downloaded it. Download the artifact again to get the current branding.

> [accordion] Can I export without branding?
>
> Not as an option. Every export uses the workspace's current branding. To get an unbranded copy, remove the logo, clear the company name, reset the colors, save, export, then restore your settings. Everyone exporting from the workspace in the meantime gets unbranded PDFs too. If you need unbranded exports often, use a separate workspace without branding.

## Next steps

> [card] [Artifacts](https://docs.cloudthinker.io/guide/artifacts/overview.md)
>
> Generate the dashboards and reports your branding applies to.

> [card] [Sharing](https://docs.cloudthinker.io/guide/sharing.md)
>
> Share branded artifacts with people outside your workspace.


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