Customising the Login Page

It's fairly straightforward to customise the Confluence login page, to add your own logo or custom text. This will not customise the login process however, just what a user sees when she logs in.

Customisations to the Confluence login page will need to be reapplied when you upgrade Confluence. Consider this before making drastic changes to the layout, and be sure to keep a list of what you have changed for your upgrade process later.

Only administrators with access to the server where Confluence is running can modify the Confluence login page.

Process to change the login page

1. Shut down your test instance of Confluence.

2. In the Confluence web application folder, find the file confluence/login.vm.

3. Make a copy of this file as a backup.

4. Edit the file with a text editor to make the required changes. The content is mostly HTML, but has some Velocity template variables in it. See Velocity Template Overview for more information about how these work.

5. Start Confluence up again and test your changes.

6. Apply the changes to your production Confluence instance.

The same process can be applied to modify most of the templates in the Confluence web application. Be careful to test your changes before applying them to a live site. The templates contain code that is vital for Confluence to function, and it is easy to accidentally make a change that prevents use of your site.

Customising the Login Page

Process to change the login page

Related topics

Labels