---
title: Visual theme & branding
description: Make TSync look like your brand — primary and accent colours, corner radius, font and sidebar tokens, with a live preview that also reaches the login page, PDFs and e-mails.
product: TSync Intelligence 11.3.6
language: en
canonical: https://docs.tsync.pro/theme/
source: https://docs.tsync.pro/llms.txt
---

# Visual theme & branding

You can make TSync match your brand — its main colour, accent colours, corner roundness and font — from one
screen, with a **live preview**. Your choices apply across the whole admin area.

## Open it

Go to **Setup → Configuration Center → Theme & Branding** (`/admin/tsync_theme_manager`).

## Change your colours

- **Brand colour** — the main colour for buttons, links and highlights.
- **Success / Warning / Danger** — the accent colours for confirmations, warnings and delete actions.

Click a colour, pick a new one, and watch the **preview** on the right update instantly. Nothing is saved
until you click **Save theme**.

## Roundness and font

- **Corner radius** — how rounded buttons and cards look (drag the slider).
- **Font** — the typeface used across the interface.

## Sidebar colours

You can colour the **left sidebar** to match your brand from here too — a **background**, and optionally a
**text** and **accent** colour. Leave them **empty** for the automatic look (the default light sidebar).

- **Contrast is handled for you.** Pick a dark background and TSync keeps the menu text light and readable;
  pick a light one and it switches the text dark. Hover and the active item stay legible either way, and a
  white logo is used on a dark sidebar — so you never end up with unreadable dark-on-dark menus.
- **One setting, both menus.** The same colours drive **both** the main sidebar **and** the
  [Configuration Center](configuration-center.md) hub menu, so your branding is consistent everywhere — no more
  a readable sidebar but a dark-on-dark hub.

## Night mode

TSync can show the whole admin in a **dark appearance**. On this same screen there's a **Night mode**
setting, chosen **per company**:

- **Off** — everyone sees the normal light theme (this is the default).
- **Per user** — a **Sun/Moon button** appears in the top bar, and each person switches the whole admin
  between light and dark for themselves.

Each person's choice is **remembered per browser**, so it's personal to that user and that device. The very
first time someone opens TSync, it follows their computer's own light/dark preference.

On a multi-company install this is **per company** — one company can turn night mode on while another stays
light.

## If you asked your computer to reduce motion, TSync listens

Every operating system has a **reduce motion** setting, used by people who get dizzy, nauseous or a migraine
from movement on screen. From v11.1.4 the admin interface honours it: panels, drawers, menus and hovers stop
animating and simply appear.

You do not switch this on in TSync. It follows the setting you already made in Windows, macOS, iOS, Android
or your browser, and it applies to **every** admin page, not only the modern ones.

**Movement driven by JavaScript is not covered yet** — a small number of animations are written in code
rather than in the stylesheet, and those still run. We would rather say so than let you discover it.

> This is not the same thing as [night mode](#night-mode). The admin theme never follows your operating
> system's light/dark preference — you choose it here — but reduce motion is a genuine accessibility request
> and is obeyed.

## Logo & favicon

This screen also has a **Logo & favicon** card with three uploads — each with a preview and a **Remove**
button:

- **Logo** — your company logo.
- **Logo for the dark sidebar** — shown when the sidebar is dark, so the logo stays visible.
- **Favicon** — the little icon in the browser tab.

These are stored **per company**, so two companies sharing one install can each carry their own logo and
favicon. If a company doesn't set its own, TSync falls back to the global logo and favicon.

> There's also an optional **Favicon (dark theme)** upload on **Setup → Settings → General**, next to the
> normal favicon — a light/white icon that browsers show when the visitor's device is in dark mode. If you
> don't set one, the normal favicon is used. It complements the Night mode theme above.

### Your branding survives an upgrade

Your **company name, logo and favicon are yours** — upgrading TSync never replaces them. If an install has no
branding of its own, TSync applies its own default brand, but the moment you set your own it is kept from then
on, through every future upgrade.

> If an earlier upgrade did overwrite your favicon or company name, set them once more (**Setup → Settings →
> General**, or the **Logo & favicon** card above). They will stay put from now on.

## Document header & footer (letterhead)

Further down the same page is **Document header & footer (letterhead)** — a branded band that prints on the
**PDFs** your customers receive, and on e-mails.

**Nothing changes until you switch it on.** You fill in a header and/or a footer block, then tick the document
types it applies to under **Apply to**: contracts, invoices, estimates, proposals, credit notes, e-mails and
e-mail templates. All of them start unticked, so an install that never opens this section keeps exactly the
documents it had.

**Filling it in**

- **Header HTML / Footer HTML** — the content of each band. If you would rather not start from an empty box,
  press **Brand-band starter** and edit what it puts there.
- **Header height / Footer height (mm)** — how much room the band reserves on the page. Too small and the band
  overlaps the document body; the live preview beside the fields shows the result while you type.
- **Header on / Footer on** — **every page** or **first page only**.

**Company fields, written once**

Under **Company fields** you enter the details the bands print: director, registration code, website, shop
website, bank, BIC/SWIFT and the **IBAN for MDL, USD and EUR**. In the header and footer HTML you refer to them
as tokens — `{company_iban_mdl}`, `{company_bank}`, `{company_reg_code}` and the rest — so changing a bank
account later means editing one field here, not every template you have ever made.

Those same tokens also work **in the body of a contract**, and the contract editor lists them in its merge-field
panel under **Company (document header)** so you can click one in rather than typing it. A token that means one
thing in the header means the same thing in the body.

> If a `{...}` token ever prints literally in a finished PDF, the field behind it is empty or the token is not
> one of the registered ones — check the spelling against the merge-field panel.

Everything here is saved per company: with [multi-company](multi-company.md) on, the letterhead you save while
inside a company belongs to that company.

## Advanced CSS

For power users, an **Advanced CSS** box lets you add a little extra custom styling on top of your theme. It's
for small, safe touch-ups; TSync **cleans and bounds** what you enter (no unsafe content, no external
references) and applies it **last**, so a genuine one-off tweak wins over the theme defaults.

> This box **replaces the old Theme Style customizer**, which has now been retired and no longer ships. If you
> had custom CSS there, TSync moved it into Advanced CSS for you when you upgraded — so your styling lives in
> one place.

## Presets

Not sure where to start? Click a **preset** — TSync default, Indigo, Emerald, Slate or Rose — to apply a
ready-made palette, then fine-tune from there.

## Save, or start over

- **Save theme** applies your choices across the admin.
- **Reset to defaults** returns everything to the standard TSync look.

> **Tip:** keep the brand colour readable — buttons show white text on your colour, so very light colours can
> be hard to read. The preview shows you exactly how it looks before you save.

## Your customers' portal

Your customers log in to their own portal to see their invoices, projects, contracts and support tickets. It
carries your company branding, and TSync keeps it on the **current design**.

If your portal was still being drawn by the retired design from before the platform was modernised, upgrading
**moves it to the current one automatically** — there is nothing to click. Your previous setting is stored, so
the change can be undone at any time. A portal you have deliberately customised yourself is **never touched**;
only that one retired design is replaced.

> **This is a security fix, not a cosmetic one.** Five pages of the retired design — profile, contacts, saved
> payment card, files and the project files list — let an item be deleted by simply following a link, without
> the safeguards the rest of TSync uses. Moving to the current design removes them.

The current design has every page the retired one had, so nothing your customers use disappears.

**If the design folder ever goes missing**, TSync now falls back to the design that ships with the product and
records that it did so. Previously the entire customer portal was replaced by an error page while your
administration area looked perfectly healthy — which meant everything seemed fine to you while nothing worked
for your customers.

**Worth doing once after an upgrade:** open your own customer portal — the login page is enough. You should see
the current design with your branding.