The Spaces module is ideal for showcasing related team or project spaces in a single view. It can also be used to display a list of spaces, with optional filtering by space category, making navigation more focused and organized.

Insert Spaces

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

Open the page you want to edit, or create a new one.
In edit mode, click the ‘+' icon in the toolbar or press '/' on your keyboard to open the module menu.
Type "Spaces" or "Optics" in the search bar and select "Spaces (by Optics)" or "Optics" from the list to open a configuration dialogue.
In the configuration dialog, choose a Spaces template and customize it using the live preview. The available customization options depend on the template you choose.
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.

Configuration

When the module dialog opens, a live preview displays the latest spaces from the Confluence instance, ready to be customized to fit the intended use case.

Start with templates

Creating Spaces start with choosing a template: Card, and List. 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.

Layout

The Layout tab defines how spaces is presented, offering options to control how all items appear within the module. Available options may vary depending on the selected template.

Display Options

In the Display section, there is an option to configure pagination. Available pagination types include Show More, Previous/Next, and None. The Per Page setting is available for all templates.

Flexible display elements

Spaces module can be customized by enabling or disabling elements such as Author, and Description. This allows flexible presentation of spaces content, adapting the appearance to various communication goals or visual styles.

Styling

Styling options include only corner radius. Available styling options are defined in the Optics Style Guide to maintain consistency across all formatting modules.

Content

The Content tab defines the source of the spaces and controls which content is displayed. Content can be configured in two ways: Dynamic or Manual.

Dynamic

By applying filters, the widget automatically updates to display newly published content that matches the defined criteria. This ensures the spaces feed stays current without requiring manual updates. Content can be filtered by categories, spaces type, and space status, allowing precise control over what is shown.

Manual

This method enables manual selection of specific spaces for display. It offers greater control over the content shown but requires manual updates to include new spaces, making it a more curated and less automated approach.

Group Spaces in tabs

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

The Layout settings applies globally to all tabs within the Spaces module, ensuring a consistent visual style across each section. The Content, however, is configured separately for each individual tab. This means that content, whether set manually or dynamically, must be defined per tab, allowing each one to display different sources or filtering rules as needed.

Personalized content

View permissions can be managed globally for the entire module or individually per tab when tabs are enabled. Using Collections from Cosmos, it's possible to define exactly who can see specific content. This enables personalized experiences, where different tabs are visible to different audiences, each showing tailored information based on user groups.

The personalization feature, powered by Cosmos – Intranet for Confluence, enhances this even further. With tabs, each section can reflect a unique theme or target group. Without tabs, the entire module can be focused on a specific audience, creating a unified and purposeful display. To learn more about content personalization, check the Personalization powered by Cosmos page.