Customizing the Login Page

In Confluence 9.1, we updated the Confluence login experience and included a second authentication layer for added security. As a result of this change, the login page can no longer be customized.


This page gets you started on customizing the Confluence login page, to add your own logo or custom text. This will not customize the login process, just what users sees when they log in.

Notes:

  • Customizations 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.
  • Please test your changes on a test Confluence site first.

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

To change the login page:

  1. Shut down your Confluence server.
  2. In the Confluence installation directory, 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 contains a mixture of HTML and Velocity. See Velocity Template Overview (in our developer documentation).
  5. Start Confluence and test your changes.

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.

If you've upgraded from 8.7.x or earlier, make sure you update the login template.
Remove:

#parse ("/langmacro.vm")
<html #langAttr()>

and replace it with:

<html lang="$action.getLanguageJs()">
Last modified on Sep 24, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.