Cards in Optics make Confluence pages more visual and organized. They break content into clear, readable sections that highlight key points and guide readers through information easily. This improves communication and makes pages more engaging and user-friendly.

Open

New Card Templates

Insert Cards

Follow these steps to insert a Cards module to your Confluence page:

1. Open the page you want to edit, or create a new one.

2. In edit mode, click the ‘+' icon in the toolbar or press '/' on your keyboard to open the module menu.

3. Type "Cards" or "Optics" in the search bar and select Cards (by Optics) from the list to open a configuration dialogue.

4. In the configuration dialog, choose a card template and customize it using the live preview. The available customization options depend on the template you choose.

5. Once you're happy with the setup, click Add to page to insert the module. To cancel, simply click Cancel, and the module won’t be added.

Start with templates

Creating cards starts with choosing a template, Image, Emoji, or Illustration. Each one is crafted by our design experts to help you build outstanding, consistent content in Confluence. We're continuously adding new templates to keep your pages fresh and visually engaging.

Configuration

All card templates include two types of settings: global settings that apply to all cards, and individual settings that appear when you click to select a specific card.

Global settings

Global settings apply to all cards within the module and cannot be customized for individual cards. These options are visible only when no card is selected, allowing consistent styling and layout across the entire set.

Flexible display elements

Card elements such as label, subtext, arrow, and link text can be enabled or disabled. Available elements vary depending on the selected card template.

Styling options

Styling options include corner rounding and color customization. The color picker uses a two-color scheme, accent and text colors, designed to keep cards visually consistent with dark mode and the overall design system. Read more about Optics Styleguide.

Individual Settings

Individual settings appear when a card is selected, allowing customization of that specific card’s content and layout. These options enable fine-tuning elements such as text, icons, images, and more, without affecting the rest of the cards in the module.

Image

Image templates support multiple image sources, including Unsplash, direct links, library, and page attachments.

• Unsplash offers a built-in library of high-quality, royalty-free images that can be added to cards with just one click, no need to upload anything manually.

• Direct link allows using an image by pasting its URL. This is useful when the image is hosted externally, just copy the image link and it will be displayed in the card without needing to upload it.

• Library is connected to the Optics Styleguide and allows uploading and storing company-approved images. These images can be reused across cards to keep visuals consistent with brand guidelines.

• Page Attachments lets users select PNG or JPG images stored on any Confluence page, across any space. Images can also be uploaded directly through this feature, making it easy to use existing or new content from Confluence.

Link

Each button can link to one of the following options, with settings to choose whether the link opens in the same tab or a new tab:

• Confluence page: Supports filtering and search to quickly find relevant content in Confluence.

• External URL: Accepts any valid link; just paste and save.

• Email address: Opens the user's default email app with the address pre-filled, ideal for support or contact scenarios.

Content

While all content can be edited inline, the right sidebar also provides full access to content settings. It adjusts based on the selected template and reflects the visibility of options set in Global Settings. Cards under the Emoji templates support three types of visual elements:

• Emojis can be used to add personality and expressiveness to cards, making content feel more engaging and friendly

• Icons are available from four built-in libraries, offering a wide variety of styles to match different use cases, from playful to professional.

• Logos are part of a dedicated feature connected to the Optics Styleguide. This allows Confluence admins to upload, manage, and use approved company logos across cards and other modules.

Styling options

At the card level, it is possible to adjust colors for an individual card. Colors selected in the individual settings will override the global settings.

Inline editing

Card content can be edited directly within preview mode using inline editing, allowing for quick and seamless adjustments.

When hovering over a card, a quick-access toolbar appears. It includes commonly used options such as the image picker, link picker, emoji picker, as well as actions to reorder or delete the card. This toolbar is designed to streamline access to the most frequently used customization options.

Group cards in tabs

Tabs in Cards help organize related content in a clean, structured way, all within a single module. Instead of creating multiple separate Cards modules for different topics, tabs allow grouping them together, making content easier to manage and navigate.

Edit/Remove Cards

To edit or remove a Cards module from a Confluence page, follow these steps:

• Open the page where the Cards module is located

• Click Edit to enter page editing mode

• Locate and select the Cards module that needs to be updated or removed

• A small Confluence toolbar will appear above the module, offering options to edit, duplicate, or delete

• Click Edit to update the content or Delete to remove the module from the page