You can modify Confluence's look and feel by editing the 'decorator' (layout) files. This page tells you how to customise the layout files for a space

Confluence system administrators can also customise the layout of their entire Confluence site as a whole. For more information, please refer to Customising Site and Space Layouts. Site layout customisations modify the default layout of all spaces in the Confluence site. However, any space layout customisations will override the equivalent site customisations.

A note about permissions: To perform these customisations, you will require space administrator permissions for that space. For security reasons, you must also have Confluence system administrator permissions to modify any space layout throughout your Confluence site.

Confluence is built on top of the Open Source SiteMesh library, a web-page layout system that provides a consistent look and feel across a site. SiteMesh works through 'decorators' that define a page's layout and structure.

To edit the layout of Confluence, you will need to modify these decorator files. A decorator file is a .vmd file and is written in a very simple programming language called Velocity. Learn more about Velocity. Once you become familiar with Velocity, you can edit the decorator files to personalise the appearance of Confluence.

The decorator files in Confluence are grouped into the following categories:

• Site layouts: These are used to define the controls that surround each page in the site. For example, if you want to make changes to the header and the footer, you will need to modify these layouts.

• Content layouts: These control the appearance of content such as pages and blog posts. They do not change the way the pages themselves are displayed, but they allow you to alter the way the surrounding comments or attachments are shown.

• Export layouts: These control the appearance of spaces and pages when they are exported to HTML. If you are using Confluence to generate a static website, for example, you will need to modify these layouts.

Learn more about using decorators.

To edit a decorator file:

1. 
2. Click the Layout link in the left-hand panel, under Look and Feel. You will see a list of the layouts for the space.
   (Layout is displayed only if you are a Confluence system administrator.)
   • Click View Default to view the vmd file.
   • Click Create Custom to edit the default vmd file. This will open up the vmd file in edit mode.
     Make changes and click Update.

Screenshot : Edit Layouts Example

Click the thumbnail to see an example of a vmd file:

Related Topics

Customising the Look and Feel of a Confluence Space
Applying a Theme to a Space
Administrator's Guide - Design and Layout

Take me back to the Confluence User's Guide.