This page last changed on Jul 16, 2008 by mryall.

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.

Related topics

Document generated by Confluence on Nov 05, 2009 23:27