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

# Branding

> Customize your workspace's visual identity

The **Branding** page lets you configure the visual identity applied to your forms, email notifications, and the app. Access it from **Settings → Branding**.

## Images

| Image       | Where it appears                                                 |
| ----------- | ---------------------------------------------------------------- |
| **Logo**    | Top of your forms and in email notifications sent to recipients. |
| **Icon**    | Inside the Penbox app (workspace switcher, navigation).          |
| **Favicon** | Browser tab icon when recipients open a form.                    |

Click any image to open the image editor. After selecting a file, a crop dialog opens — **drag to reposition** and **scroll with your mouse wheel to resize** the image within the crop frame. Click **Pick** to confirm.

## Colors

Six colors can be customized to match your brand:

| Color       | Used for                                                        |
| ----------- | --------------------------------------------------------------- |
| **App bar** | Background of the top navigation bar in forms.                  |
| **Primary** | Main accent color — buttons, active steps, progress indicators. |
| **Info**    | Informational tags and callouts.                                |
| **Success** | Validated and completed steps.                                  |
| **Warning** | Missing or incomplete steps.                                    |
| **Error**   | Errors in steps or form elements.                               |

A live preview of your logo and primary color is shown on the right side of the page.

## Multiple brandings

If your plan supports it, you can create multiple branding profiles — useful when running forms under different brands or for different clients. Use the dropdown at the top to switch between profiles and the **+** button to add a new one.

Each branding profile has its own images and colors and can be assigned independently to forms and templates.

### Using branding on generic links

Apply a specific branding profile when someone opens a **generic link** by appending a query parameter to the URL. When you copy a generic link from Penbox, only the base URL is copied — the app does not add a branding parameter for you.

#### Step 1: Copy the generic link

1. Go to **Templates** and open the form template.
2. Click **Copy link** on the generic link card.

The base URL looks like this:

```
https://{hostname}/f/{flow-customization-id}
```

#### Step 2: Find the branding slug

1. Open **Settings → Branding**.
2. If you have multiple profiles, select the one you want from the dropdown.
3. Note the slug displayed next to the selector (for example, `slug: partner-acme`).

<Note>
  Do not use `default` as the slug — that label is for the primary workspace profile in the UI only. It is not a valid slug for URLs or the API.
</Note>

#### Step 3: Append the branding parameter

Add `branding[slug]` to the generic link:

```
https://{hostname}/f/{flow-customization-id}?branding[slug]=partner-acme
```

When someone opens that URL, Penbox looks up the matching branding profile in the workspace and attaches it to the new form.

#### Default behavior

If you omit `branding[slug]`, the form uses the workspace's default branding — the primary profile configured under **Settings → Branding**.

#### Requirements

* The slug must exist in the same workspace as the form template.
* The slug must match exactly (lowercase, as shown in **Settings → Branding**).
* If the slug does not match any profile in that workspace, the parameter is ignored and the workspace default branding is used.

#### Example

```
https://forms.acme.com/f/a1b2c3d4-e5f6-7890-abcd-ef1234567890?branding[slug]=partner-brand
```

That link creates a new anonymous form with the `partner-brand` profile applied to the form experience.

<Note>
  There is no UI option on the generic link copy button to pick a branding profile. Build the URL manually, or generate it with your own tooling or scripts.
</Note>

### Using branding via the Connect API

When creating forms programmatically, pass the branding slug in the request body instead of a URL parameter. See [Create Form](/api-reference/requests/create-request#branding) for details.