Managing branding

How to personalize your account to match your brand.

Make your Joy account feel like your own. Customize your account name, add your logo, set your color scheme, and choose banners for areas such as your login page and user profiles.

You can manage how your account looks from the Branding page in the Management Center.

Changing how your account looks

To change how your account looks, follow these steps.

Go to the Management Center and click Branding.

This opens the Branding page.

Edit the fields and settings.

You can find a description of each one in the list of fields and settings.

Check your changes in the Live preview.

You can switch between views to see how your changes look in different parts of Joy.

Click Apply.

Your changes are saved and applied across your account. Anyone who's logged in to Joy will see the changes after they refresh the page or log in again.

To undo your unsaved changes, click the Discard changes icon.

Changing a banner image

You can set a default banner that's used across your account, or customize it for each area.

To change your default banner image, follow these steps.

Go to the Management Center and click Branding.

This opens the Branding page.

In the Account Images section, click Edit banner on the Banner default image.

This opens the Edit banner window.

Choose a banner.

Pick one of the preset gradients, or click Upload to use your own image. You can upload a PNG, JPEG, or WEBP image up to 5 MB. Keep important details near the center so they aren't cropped.

If you upload an image, click Fit or Fill in the Image Settings section.

  • Fit: Shows the full image, but if it doesn't fill the banner, you may see empty space around it. You can choose a Background color for the empty space.
  • Fill: Covers the whole banner, but the edges of the image may be cropped.

The Preview shows the image with the style you chose.

Click Apply.

The window closes and the page shows your changes.

Click Apply again.

Your changes are saved and visible across your account. Anyone who's logged in to Joy will see the changes after they refresh the page or log in again.

To customize the banner for a specific area, turn on that area in Additional image defaults, then follow the same steps using that area's banner.

To quickly return to using a gradient, click the Reset to gradient icon on the banner.

Previewing your branding

Use the Live preview to see how your changes will look before you apply them. You can change what the preview shows in two ways:

  • Light and Dark: Switch between the light and dark themes. Users can choose either theme in Joy, so check that your logos and colors work in both.
  • User, Login, Asset, and KC: See how things look on a user's profile (User), the login page (Login), a file, FlexDoc, or link (Asset), or the Knowledge Center (KC).

Branding fields and settings

The Branding page is organized into three sections.

Identity

  • Account Name: Your organization's name. It appears at the top of the main menu.

  • Logo: Your organization's logo. It appears at the top of the main menu and on the login page. You can upload two versions:

    • Light: The logo for the light theme, which shows on light backgrounds.
    • Dark: The logo for the dark theme, which shows on dark backgrounds.

    Click an empty logo area to upload a logo, or click Change to replace one. If you upload only one version, Joy uses it in both themes. For best results, use a square image, ideally 512 × 512 pixels. You can upload a PNG, JPEG, or WEBP file up to 1 MB.

Account Images

  • Banner default: The default image that appears across the top of pages and panels throughout your account.
  • Additional image defaults: Toggles that set different default banners for specific areas of Joy. Areas that are turned off use the Banner default.
    • Asset banners: The default image that appears across the top of files, FlexDocs, and links. You can change it for an individual asset, such as a file or FlexDoc, in its settings.
    • Library and folder banners: The default image that appears across the top of the Knowledge Center and its folders. You can change it for an individual folder in its settings.
    • Login page: The image that appears on the login page.
    • User banners: The default image that appears across the top of user profiles. You can change it for an individual user in their settings.

Colors

  • Primary: Your brand's main color. Joy uses it across the app for elements such as buttons and toggles. To set it, use the color picker or enter a hex value. In some browsers, you can also use the eyedropper: click the eyedropper icon, then click anywhere on your screen to pick up that color.
  • Swatch values: Joy automatically generates this color palette based on your primary color.
    • Hex and RGB: Use the toggle to view the color codes in either format, such as #5E3099 or rgb(94, 48, 153).
    • auto: Swatches marked auto are set automatically and can't be edited.
    • AA pass or AA fail: The accessibility rating on the Primary swatch. It shows whether text on that color is easy to read, and indicates how well the color meets the Web Content Accessibility Guidelines (WCAG) for contrast and readability.
  • Banner gradient preview: A preview of the gradient Joy makes from your primary color. Joy uses this gradient for any banner that you haven't set to a preset gradient or your own image.