# Customize branding and design

<Lead>
Your workspace appears under your own brand: with its own name, logo, brand colors and favicon. This page shows where you manage all of that and how the platform design fits in.
</Lead>

## Requirements

<Info title="Permission">
Changing the name, branding and design requires the branding write permission. Owners and admins have it by default. Without it, the pages are read-only for you. More on roles: [Workspace and roles](/help/grundlagen/workspace-und-rollen).
</Info>

<Warning title="Logo and favicon start with the Compact plan">
During the trial your workspace runs under the shared platform address. You can already set your brand colors in the trial. Logo and favicon unlock with your first paid plan.
</Warning>

## Change the workspace name

The workspace name is your brand as your team and your customers see it, for example "Müller Immobilien".

<Steps>
  <Step title="Open the settings">
    Go to **Settings > Workspace** (Einstellungen > Workspace), section **Identity**.
  </Step>
  <Step title="Enter the name">
    Enter the new name (2 to 120 characters). The legal form and the official company name do not belong here; they go into the company name under **Settings > Company**.
  </Step>
  <Step title="Save">
    Confirm via the save bar at the bottom. The interface confirms with **Workspace gespeichert** (workspace saved).
  </Step>
</Steps>

## Upload a logo

Under **Settings > Branding** you manage your logo in two variants. As long as no logo is uploaded, the platform shows a monogram built from your initials.

<DefinitionList>
  <DefItem term="Icon (square)">
    A square mark used in the top bar, as the app icon and as the favicon fallback. Formats: PNG, SVG, WebP, JPG. At least 32 px, ideally 512 px. Raster images can be cropped to a square right during upload.
  </DefItem>
  <DefItem term="Horizontal wordmark">
    Mark plus lettering, for example for the top bar. Formats: PNG, SVG, WebP, JPG, wider than tall.
  </DefItem>
</DefinitionList>

Under **Display** you choose how the logo appears: **Automatic** (best available variant, the default), **Horizontal**, **Icon + text** or **Monogram**. Logo uploads apply immediately, no extra save needed.

## Set your brand colors

Brand colors are available on every plan, including the trial.

<Steps>
  <Step title="Pick the primary color">
    Under **Settings > Branding**, section **Brand colors**, pick your primary color: from the palette, from suggestions extracted from your logo, or as a hex code. The interface checks readability (WCAG contrast) live while you choose.
  </Step>
  <Step title="Optionally add a secondary color">
    Enable **Zweite Markenfarbe verwenden** (use a second brand color) if your brand uses a second color for accents. The option is off by default.
  </Step>
  <Step title="Check the preview">
    The **Preview** section shows live how the top bar and buttons look with your colors. Use the sun and moon icons to switch between the light and dark preview.
  </Step>
  <Step title="Save">
    Confirm via the save bar. The interface confirms with **Branding gespeichert** (branding saved).
  </Step>
</Steps>

## Set a favicon

The favicon is the small symbol in the browser tab. By default the browser tab shows your icon, which suits most workspaces. Only if you deliberately want a different tab symbol, upload your own under **Settings > Branding**, section **Favicon**: ICO, PNG or SVG, 16 to 512 px, square.

## Choose the platform design

Under **Settings > Design** you choose the platform design of your workspace. The choice applies to all members: dashboard, properties, tools and marketplace.

- Currently **Aurora** is available and active: warm, calm and precise, with neutral surfaces and very soft gradients as its signature. Light and dark are designed as equals.
- Two more designs are in the making and marked as **In Arbeit** (in progress). They will unlock once they are finished.
- Your brand colors and logos are preserved in every design.

<Tip title="Light or dark is personal">
Whether the interface appears light or dark is each person's own choice: in the profile menu or under **Account > Appearance**. The platform design, by contrast, applies workspace-wide.
</Tip>

## Frequently asked questions

<Faq>
  <FaqItem q="Why can I not upload a logo?">
    During the trial, logo and favicon are still locked; only the brand colors can be set. Both uploads unlock with the first paid plan (Compact and up). If you are already on a paid plan, you are probably missing the branding write permission: ask an owner or admin.
  </FaqItem>
  <FaqItem q="Where do my customers see the branding?">
    Logo, colors and favicon shape every customer-facing surface of your workspace, from the top bar mark to the browser tab. On a paid plan your workspace additionally runs under your own subdomain, and later under your [custom domain](/help/howto/custom-domain) if you want.
  </FaqItem>
  <FaqItem q="I have no logo. What does the platform show?">
    An automatically generated monogram from the initials of your workspace name, tinted in your brand color. It looks tidy, and you can add a logo any time later.
  </FaqItem>
</Faq>