Last updated Apr 24, 2024

Theming

Confluence Connect themes change the look and feel of Confluence Cloud. Your theme can change styling for the header, spaces, pages, and blog posts.

Themes aren't just for show, though. They can help emphasize parts of the UI and influence user behavior in Confluence.

How is this kind of theme different from user-driven theming?

This type of theming is controlled by the admin and affects a space or multiple spaces on an instance. Users can also use the new theme switcher to choose Light and Dark themes that use the Atlassian Design System's design tokens. These themes are picked by the user or linked to their browser setting and provide different colors for any Confluence content the user views on the entire instance, including apps that use design tokens. Admin-driven themes take precedence over the user-driven Light/Dark theme selector.

Admin themes are not selectable by the user. When choosing colors for admin-controlled themes, be sure to consider its appearance in bouth Light and Dark themes or use design tokens to provide automatic switching.

What can I build with Theming?

Theming lets you use Confluence's powerful content hierarchy and representation formats with the look and feel you're after. Enhance the user experience in a Confluence instance, whether it's for internal consumption or public-facing documentation.

Space home experiences

Integrate landing page experiences, and surface content specific to your needs.

Internal branding

Control the layout of Confluence, and synchronize it with your organization's design patterns and branding.

Tailored content experiences

Content is consumed uniquely across different industries and use-cases. Take control of this through the page and blog post routes provided by theming.

How do I build a Confluence theme?

Check out Create a Confluence theme tutorial. It'll walk you through adding a new Confluence theme to your Connect descriptor, replacing the space home page, and more.

Confluence header

Style the Confluence header, including buttons, menu items, and the search field.

Space home

Define a new space home page experience for spaces with your theme selected.

Pages and blog posts

Change the color of headings, text, menu items, backgrounds, and more. Set the appearance of hovered items, add background imagery --- it's up to you.

What other patterns might be helpful?

Page extensions

Add extra information or introduce new actions to the page byline.

Let's do this!

Get started with our theming tutorial.

  • Integrations
  • Content solutions

Rate this page: