Skip to end of metadata
Go to start of metadata

Change the interface of your Confluence.

Use your corporate design.
Include a navigation menu.

Welcome to Linchpin Theme!

This guide was created to help you with the setup of Linchpin Theme. See what can be configured and how you can do it. 

Linchpin Theme is a lightweight theme which can still be configured to fit your needs. How it looks can vary, since several of our other apps integrate with the Linchpin Theme app.

For more information, make sure to view the Linchpin Theme documentation.

Installation & licensing

Please refer to Atlassian's installation instructions: 

Installation via the Universal Plugin Manager

Step-by-step instructions

  1. Log in to your Confluence instance as an administrator.

  2. Open the Confluence general administration.
    1. Click on the Find new apps link in the sidebar.
  3. Enter "Linchpin Theme" in the search field (marked by the text "Search the Marketplace"), then press Enter.
  4. Click on "Free trial" to test the app for 30 days, or click on "Buy now" if you want to purchase a license for Linchpin Theme.
  5. You'll be prompted to register for or log into MyAtlassian.
  6. Linchpin Theme will be automatically downloaded and installed after you log-in.

Activate your theme.

To see changes within the site layout, Linchpin Theme must be active.

Activate your new theme

Navigate to Confluence administration → Linchpin Theme → Configuration.

At the very top of the page you should see a yellow warning box.

Inside this yellow box, you can find an Activate theme button. Click on the Activate theme button. 

Now Linchpin Theme should be active on your Confluence instance.

Verify that your theme is active.

You can manually look up if Linchpin Theme is activated on your system.

To verify that Linchpin Theme is active, navigate to Confluence administration → Look And Feel → Theme.

Make sure that Linchpin Theme (green icon) is selected.

If Linchpin Theme is not active, click on the Linchpin Theme (green icon) button to select Linchpin Theme. Then, click on the Confirm button.

Set up your dashboard.

With Linchpin Theme, you can customize the look of your dashboard.

You can, for example, disable the default Confluence sidebar, change the background, create custom dashboard layouts etc.

Access the settings

Navigate to Confluence administration > Linchpin Theme > Configuration > Dashboard.

Choose a dashboard layout.

You can decide between the Linchpin dashboard and the default Confluence dashboard.

Linchpin dashboard

There's only one section (full-width design). The content is centered. You can fully customize the content.

Default Confluence dashboard

The dashboard is divided into two sections. The left section has a predefined Confluence panel, enhanced with new functions. You can fully customize the content of the right section. You can also define the width of the right section.

Linchpin dashboard

Default Confluence dashboard

Style your dashboard.

Choose a background for your dashboard, enable or disable additional buttons and enable tile layout, if you wish.

Dashboard background

You can either upload a background image or select a background color.

The background color is not visible when a background image is set.

Tile Layout

Enable the Tile Layout checkbox to give every macro a white background.

This is a very useful feature because some macros have a transparent background. Also, Tile layout adds some white background around the macros. This way, headings and texts around those macros also receive a background.

Dashboard buttons

Enable the Dashboard buttons checkbox to hide the "Create Space" and "Invite User" buttons on your dashboard. This option helps to make the dashboard look more "clean".

Create your own dashboard template.

To configure the dashboard's content, you have to edit the Default Welcome Message inside the Confluence administration.

You can use the macro Layout Box to create very versatile dashboards.

Please visit the documentation on how to create dashboards to read the full guide.

Set up your header.

Upload your logo, display your Linchpin intranet name inside the header and change the whole layout of the header.

Access the header settings

Navigate to Confluence administration > Linchpin Theme > Configuration > Header.

Add a logo and/or a intranet name.

You can upload your logo and/or define the name of your Linchpin intranet.

Both elements will become links to the dashboard.


Click on the Upload file button to upload your logo.

Your logo have to be either a .jpg or a .png file. The maximum size is 560 x 140 px.

Intranet name

Enter the name of your intranet. Once you have entered the name, the options for text color and font size will appear.

The intranet name you enter here will appear next to the logo (if you have a logo for your intranet).

Your logo already has the name of your company in it? Use the "Intranet name" field for your slogan.

Position of the logo and intranet name
You can display your logo and intranet name on the left or the right side of the header. 

Left position
The logo and the intranet name appear on the left side of the header. The user menu and the search field appear to the right.

Right position
The logo and the intranet name appear on the right side of the header. The user menu and the search field appear on the left.

Define the layout of your header.

Header height

Define how big your header should be. The height can be adjusted from 80px up to 140px.


Choose a background color or and/or upload a background image.

The maximum size for the background image is 3000x140px.

If you decide to upload a header background image, you can decide if the header background image is visible on all pages or only on the dashboard.

The background color is not visible when a background image is set.

Customize your header icons and buttons

Color used for header icons

Select a color for the icons (like search or settings) inside your header.

Notification color

Select a color for Confluence workbox notifications and favorite icons.

Search and create buttons

The single ( + ) button  will always open the creation wizard. There you can choose what type of page you wish to create. You can also choose the space, in which your page should be published.

The double Create button  has two functions. 

Click on "Create" to quickly create a blank page in the space you are currently in.

Click on the "three points" button to open the advanced creation wizard.

The smaller search button  will open the search in a sidebar.

The bigger search button with an input field is a quick search. You can type in what you are looking for directly into the field.

Set up your navigation menu.

You can fully customize your navigation menu. Choose the content, the layout and the colors.

Activate your menu

Navigate to Confluence administration > Linchpin Theme > Configuration > Navigation.

Under Menu bar and Display navigation, active the show button.

Add menu items to your menu

Main menu item

To add an item to the main menu, click on the + Main menu item button.

The new item will be added to the bottom of the list.


Enter a title (for example About us) and the link to the page this item should lead to. You can also choose an icon for this link.

Enter the attributes which are defined in menu personalization. Those information are connected to user profiles. If you enter "USA" as a country, the menu item will only be shown to employees with "USA" chosen as a country insider their user profile. 

Activate the Open in new tab checkbox if you want that the link opens in a new tab.

To add another main menu item, repeat this step.

Adding category and submenu items works in an almost identical way.

Reorganize your menu.

To convert items into others, use the Arrow buttons inside the Position tab

The Right arrow  button will convert a main element into a child element.

The Left arrow ← button will convert a child element into a parent element.

Alternatively, you can use drag and drop to convert menu items.

Set up your sidebar.

The Linchpin sidebar offers multiple functions. The amount of functions you have access to depends on other installed Linchpin apps.

Activate your sidebar.

Navigate to Confluence administration > Linchpin Theme > Configuration > Linchpin sidebar.

Alternatively, click on the settings icon in your Linchpin header, then click on Theme > Linchpin sidebar.

Activate the Show checkbox to enable the Linchpin sidebar.

Configure the sidebar.

Scroll behavior of the sidebar icons

Activate one of the two checkboxes.

The first checkbox gives the sidebar a fixed position.

The second checkbox will make the sidebar scroll with the rest of the page.

Background color of the sidebar icons

Set the background color of the icons which are displayed when the sidebar is collapsed.

Color of the sidebar icons

Set the color of the sidebar icons which are displayed when the sidebar is collapsed.

Linchpin sidebar configuration menu

Set up your footer.

You can create up to two additional link containers inside the footer. You can also style your footer.

Access the footer configuration

Navigate to Confluence administration > Linchpin Theme > Configuration > Footer.

Alternatively, click on the settings icon in your Linchpin header, then click on Theme > Footer.

Style your footer.

You can style your footer accordingly to your corporate design.

Background color

Set the background color for your footer. 

Color of headlines in the footer

Set the color of the headlines inside the footer.

Color of links in the footer

Set the color of the links inside the footer.

Configure the content of your footer.

Navigate to Confluence administration > Linchpin Theme > Footer configuration.

Add new footer columns

You can have a maximum of 2 custom columns inside your footer.

To add new columns, click on the + Add column button.

Edit footer columns

Click on the edit  button inside the column you wish to edit.

A new window will open. Here, you can define the column title.

Furthermore, you can add links to your footer column. Click on the + Add link button. Now, insert the name of the link and the address of the link.

Activate the New tab checkbox if you wish that the link will be opened in a new tab.

Click on the Apply button to save your changes.

More Features

A choice of more features which you can find in the full documentation.

To view the full feature list, visit the Linchpin Theme documentation.

This page was last edited on 10/13/2022.