--- title: Branding description: Brand configurations hold your primary, secondary and chart colors so dashboard widgets can be recolored to match a company or a client in one click. Upload a logo and the platform will suggest matching palettes. source: https://documentation.controlcomtech.com/platform/branding --- # Branding A brand configuration is a named set of colors: a primary, a secondary, and the palette used for graph lines and other chart elements. Once saved, it can be applied to a dashboard so every chart on the board matches the company whose data it shows. > **Workflow Stage: Visualize** ## Overview Open **Settings**, stay on the **General** tab and click **Manage** on the **Branding** row. The page lists the brand configurations your Organization has, each as a row showing its name, a preview strip of its colors, and a summary of what it defines (Primary, Secondary and how many chart colors). Hovering a row reveals **Edit** and **Delete**. On a new Organization the list is replaced by an empty state, **No Brand Configurations**, with a **Create Brand Configuration** button. ![The Branding administration page in ControlCom Connect listing saved brand configurations with color previews](https://documentation.controlcomtech.com/images/small-areas/03-branding-list.png) *Brand configurations, each with a preview of the colors it defines* Nothing here changes the look of the app itself. The sidebar and logo you see across ControlCom Connect come from the **Colors** and **Logo** rows on the Organization tab in Settings. A brand configuration is narrower and more useful for reuse: it is a palette you attach to dashboards, and you can keep several of them. That distinction is what makes the feature worth the extra step. A services company monitoring three hospitals can hold a brand configuration per client and recolor a copied dashboard to whichever one it is being handed to, without editing widgets one by one. Reaching the page requires the `ReadOrganizationConfiguration` permission, the same one that gates Settings. ## Creating a Brand Configuration Click **New Brand** in the page header, or **Create Brand Configuration** from the empty state. Both open **Create Brand Configuration**, a single form on a card headed **Brand Colors**. **Name** identifies the configuration in the list and in the dashboard editor. Name it after what it is for rather than what it looks like, since that is how you will pick it later: a client name, or `Main Brand`. **Primary Color** and **Secondary Color** are the two anchor colors, each set through a color picker. They are not separate from the chart palette: the primary is always chart color 1 and the secondary is always chart color 2, and changing either rewrites the matching slot for you. **Chart Colors** is the ordered list a graph draws its series from, up to ten entries. The first two are locked to Primary and Secondary and are shown as read-only swatches; the rest are editable, removable, and extended with **Add Color**. Order matters, because a graph consumes the palette from the top: the first series takes chart color 1, the second takes chart color 2, and so on. Click **Create Brand** to save. Editing an existing configuration opens the same form under **Edit Brand Configuration**. ## Suggesting Colors From a Logo Rather than sampling hex values out of a brand guide by hand, upload the logo and let the platform read it. The **Logo** field takes an image and crops it square. Once one is uploaded, a **Suggest Colors** button appears next to it. Clicking it analyzes the image and returns a set of complete palettes under **Suggested Color Palettes**, each shown as its primary and secondary swatches followed by the chart colors it proposes, with a short explanation of the reasoning above them. Click **Apply** on a palette to load it into the form. It is a starting point, not a commitment: every color remains editable afterwards, so the usual path is to apply the closest suggestion and then adjust one or two swatches. The logo is only used to derive colors. It is not shown on dashboards, and it is not the logo used in the navigation or on reports, which is set on the Organization tab in Settings. ## Applying a Brand to a Dashboard Brand configurations are consumed in the dashboard editor, in two places. The **Branding** panel in the editor's left rail lists every configuration that defines chart colors, each with a preview of its palette. Choosing one recolors the whole board at once. Graph widgets take up to ten chart colors in order, and radial gauges take the primary color for the needle. Widget types that carry no color of their own are left untouched. For a single chart, open the graph widget's settings and use **Use Brand Colors** in the color picker. It offers the same list and replaces just that widget's series colors. Both routes write ordinary widget colors, so nothing stays linked afterwards. Editing a brand configuration later does not repaint boards you have already published; reapply it in the editor and publish again. ## Related Workflow Stages Branding belongs to the Visualize stage and only matters once there is something to look at. Build the board first ([Creating a Dashboard](https://documentation.controlcomtech.com/platform/dashboards/creating)), then apply a brand before it goes in front of the people it was made for. The rest of the Organization's appearance, including the app colors and the logo printed on reports, lives on the Organization tab in [Settings](https://documentation.controlcomtech.com/platform/settings).