Optics Style Guide

SCreating an Optics Style Guide ensures a consistent design across all Confluence pages, including blogs and knowledge articles, while clearly reflecting the company’s brand identity and vision.

The Optics Style Guide can be accessed by navigating to Apps in the Confluence navigation bar and selecting Optics Style Guide from the dropdown. This is the central place for managing your visual elements, and branding assets.

Style Guide permissions

By default, Confluence admins have full access to manage the Optics Style Guide. Additional users or Confluence groups can be granted permission by following these steps:

Go to Confluence Administration
Open the Style Guide section under Settings section.
Under Permissions, add the users or Confluence groups you want to give permissions to.

This allows selected users to manage the image library, logos, and color settings, and to create module templates for cards, buttons, and panels that can be used by all Confluence users.

Setting up the Optics Style Guide

Set your company’s primary brand color and secondary accent using predefined Atlassian palettes or custom values.
Define how light mode colors translate into dark mode to maintain visual consistency for users who prefer dark themes.
Apply a consistent rounding style, from sharp edges to fully rounded corners, across all modules for a unified visual appearance.
Choose a button style that aligns with your brand. Since buttons are key call-to-action elements, this ensures consistency throughout the Optics experience.

If the Style Guide is not configured, Optics will automatically apply the Atlassian standard color palette and default rounding settings. This ensures a consistent appearance, but configuring the Style Guide is recommended for full brand alignment and a more personalized experience.

Colors

Colors defined in the Optics Style Guide are used throughout the macro settings to ensure a consistent and unified look across light and dark modes. The color system is based on a two-color scheme:

Accent Color: Used for key visual elements such as buttons, labels, and backgrounds.
Text Color: Controls the text within these elements.

By default, the text color adapts automatically to the selected accent color for optimal contrast. However, it can also be manually adjusted when needed.

Images

A collection of images can be added to help define the visual style for Confluence pages. These images can be used for inspiration and applied in cards, and other places where images appear in Optics modules.

It is possible to save up to 20 images. Allowed image formats are JPG, JPEG and PNG. There is no limit for the image size, but we recommend to keep it under 1MB.

Click the Add Image button.
Copy the image address (URL) of the hosted image. Only images available online with a direct link can be used.
Enter a title for the image.
Paste the image address into the provided field.
Click the Add button to save the image to the gallery.

Logos

Logos help maintain a consistent brand identity across Confluence pages. They can be used in cards for quick visual recognition, for example, adding a company logo to a card that links to internal tools, services, or external platforms. Logos are managed through the Optics Style Guide only and stored in a central library, making them easy to reuse across different modules.

Click the Add Logo button.
Copy the logo image address (URL). Logos must be hosted online and accessible via direct link.
Enter a title for the logo.
Paste the logo image address into the provided field.
Click the Add button to save the logo to the library.