<!-- https://unlockos.io/manual/app-brands -->

# App Brands Help

## Overview

**App brands** lets you design how the **apps your guests open** look, per organization. A brand bundles a name, a main colour, an accent colour, a logo, a favicon (app icon) and the name shown on the home screen. You then pick which brand each app uses.

One organization can run apps under several brands side by side — for example your own brand and a co-brand shown under a tenant's or partner's name — all from the same admin screen.

These apps, and the LINE rich menu, can use a brand:

| App | Chosen per |
|-----|------|
| Facility page (Go) | facility |
| Member | facility |
| Booking | booking config |
| Check-in | check-in config |
| Locker | locker config |
| LINE rich menu | facility with LINE connected (colours only) |

A brand is not tied to an app type, so the same brand can be used by several apps.

> App branding is a **paid option**. Pricing, the 14-day free trial, and subscribing or canceling are on the [Options tab of the billing page](billing.md#options-tab).

---

## Who can open it

Only **organization owners** can open this menu. Facility owners and facility members do not see it.

The menu is in the account panel at the bottom left, under **Organization** (the same place as Billing).

---

## Without the paid option

Creating, editing and assigning brands needs the "App branding" paid option (the 14-day free trial counts). For an organization without it, the top of the page says **This needs the "App branding" paid option**, and **Add brand** and edit are disabled. In the dropdown for each app you can only put an app that has a brand **back to Standard (UnlockOS)** (other brands cannot be chosen). **Add the option** in that notice takes you to the Options tab of the billing page.

| Option status | Guest app | What you can do here |
|-----|------|------|
| Trial, active, canceling (until the period ends), payment pending (the 7-day grace) | The brand's look (facility page, member, booking, check-in, locker and the LINE rich menu alike) | Everything |
| Never added, or ended | **The standard (UnlockOS) look** (the LINE rich menu returns to the UnlockOS colours within about 10 minutes) | View the list, delete brands, put apps back to Standard (UnlockOS) |

When the option ends, your brands and the brand chosen for each app are **kept**. Add the option again and your look comes back right away. Keys (PIN codes and QR codes), prices and reservations do not depend on the option.

---

## Create a brand

1. Press **Add brand**
2. Fill in the fields

| Field | What it does |
|-----|------|
| Brand name | Shown in the header and the browser tab. Up to 40 characters |
| Name on the home screen (optional) | The app's name when a guest adds it to their phone's home screen. Leave empty to use the brand name. It is cut at about 12 characters under the icon, so keep it short (up to 20) |
| Main colour | Buttons, the selected item, the selected dates in the calendar — the parts guests interact with. The tint of the facility page and guest-register bands follows this colour too |
| Accent colour | The other end of the gradient, e.g. the header icon |
| Logo | Shown in the header. Wide images are scaled to fit 480 × 160 |
| Favicon / app icon | Used for the browser tab and the home-screen icon. A square image works best (saved as 512 × 512) |

3. Check the header and button in the **Guest screen preview** on the right
4. Press **Save**

Pick a colour from the swatch, or type it as `#RRGGBB` (e.g. `#EE6600`).

Images can be **PNG, JPEG or WebP**, up to **1 MB** each. SVG is not accepted.

### Readability warning

If the main colour is too light, the white text on buttons becomes hard to read and a warning appears under the colour fields. You can still save, but check in the preview that the button label is readable.

---

## Give an app a brand

**App brands** at the bottom lists, for every facility in your organization, the apps that can use a brand. The label at the top left of each row says which app it is.

- **Facility page (Go)** and **Member** have one row per facility (the config name reads "Whole facility")
- **Booking**, **Check-in** and **Locker** have one row per config (a row appears once the config is created)

1. Open the dropdown next to the row
2. Choose the brand

It is saved as soon as you choose, and guests who open that app's URL see it right away.

To go back to the original look, choose **Default (UnlockOS)**.

---

## LINE rich menu colours

A facility with LINE connected has a **LINE rich menu** row. Choosing a brand makes the rich menu's **background the brand's colours** and publishes the menu again right away (reopen the LINE chat to see it).

| Changes | Stays the same |
|-----|------|
| The background gradient (main colour → sub colour) | No logo. The layout, icons and text stay as they are |

- Text and icons **stay white**. A colour too light for white text is drawn a little darker, just enough to read (for example a sub colour of `#EBEBEB` becomes about `#949494`)
- **Changing a brand's colours or deleting the brand** republishes the rich menu of every facility using it. Changing only the name, logo or favicon does not (they are not on the menu)
- Up to 3 facilities are republished at once. With more, you see "The LINE rich menus of the remaining facilities will switch shortly" and the rest switch automatically
- If a facility could not be republished, a notice appears at the top right. Publish the menu again from [LINE connection](line-connection.md) (the brand itself is saved; it is also retried automatically every hour)
- A facility whose LINE is disconnected says so on its row. Once reconnected, the menu is published in the chosen colours
- The **preview** in the rich menu settings of [LINE connection](line-connection.md) uses the brand's colours too
- The first screen when an app is opened from LINE ("Signed in with LINE") shows the facility's name and a "Continue" button in the LINE brand's colour (LINE green without a brand)
- The **LINE rich menu sample** in the brand editor shows the menu's colours before you save. When a colour is drawn darker, the sample says so (the buttons are a sample; the real menu depends on the facility's apps)
- Publishing the menu from [LINE connection](line-connection.md) while the colours are being switched says "being switched right now". Wait a few minutes (up to 5) and publish again (your settings are saved)

---

## What changes on the guest screen

| Where | What |
|-----|------|
| Header | Logo and brand name (without a logo: an icon in the brand colours and the brand name). The facility name stays where it is today |
| Colours | Buttons, the selected item, the calendar, the card field border, etc. The bands and heading rules of the facility page, Member and the guest register take the tint of the main colour |
| Background | The pale page background takes a tint made from the main and sub colours (apps without a brand keep today's background) |
| Browser tab | The title becomes the brand name (Booking and Check-in: "Facility name \| Brand name") and the icon the favicon |
| Add to home screen | The app name and icon are the brand's |
| "Powered by UnlockOS" | No longer shown (the facility page footer, the Member and Booking sidebars, the foot of the Check-in screens) |

Keys (PIN / QR code), prices and booking details do not change with the brand.

---

## Edit or delete a brand

- Edit with the pencil icon. Saving updates every app that uses the brand
- Delete with the delete icon. Apps that used it go back to the **Default (UnlockOS)** look

An organization can have up to **20** brands.

---

## FAQ

**Q. Does the icon change for guests who already added the app to their home screen?**

A. An icon and name already added to a device may stay as they were when it was added. Guests who add it from now on get the brand's icon and name.

**Q. Can facilities use different brands?**

A. Yes. Brands belong to the organization and are chosen per app (per facility for the facility page and Member, per config for Booking, Check-in and Locker), so even within one facility each app or config can use a different brand.

**Q. Can the facility page (Go) and Member use different brands?**

A. Yes. They are separate rows even for the same facility, so each can have its own.

**Q. Are changes recorded?**

A. Yes. Creating, editing and deleting a brand, and assigning it to an app, are recorded with who did it and when.

**Q. What happens to the guest app when the paid option ends?**

A. The brand comes off and every app (facility page, member, booking, check-in, locker) opens in the standard (UnlockOS) look, and the LINE rich menu is republished in the UnlockOS colours within about 10 minutes. The apps keep working, and keys and reservations are not affected. Your brands and the choice for each app are kept, so adding the option again brings your look back.
