Customizing the Login Page

In Confluence 9.1, we updated the login experience and included a second authentication layer for added security. As a result of this change, if you wish to customize the login page in Confluence 9.1 or later, you need to switch back to the legacy login form, which will disable two-step verification.

This page gets you started on customizing the Confluence login page, to add your own logo or custom text. 

Before you begin

The legacy login form doesn’t support two-step verification. You should only revert to it as a last resort to customize login screens temporarily, as it degrades the security level on your instance.

Only admins with access to the server where Confluence is running can modify the Confluence login page. You can use the same process to modify most of the Soy templates in web and desktop versions of Confluence.

Here are some additional details to keep in mind:

  • You’ll need to reapply customizations to the Confluence login page when you upgrade Confluence. Consider this before making drastic changes to the layout, and be sure to keep a list of what you've changed for your upgrade process later.

  • The legacy login form has a lower security level as it disables two-step verification.

  • Test your changes on a staging environment 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 your site from being used.

Customize the login page

  1. Shut down your Confluence server.
  2. Enable the legacy login form by using the JVM flag Datlassian.authentication.legacy.mode=true
    Configure System Properties
  3. In the Confluence installation directory, find the jar file confluence/WEB-INF/atlassian-bundled-plugins/com.atlassian.confluence.plugins.confluence-frontend-X.Y.Z.jar where X.Y.Z is the confluence-frontend version.
  4. Follow the app modification steps mentioned in How to edit bundled or system plugins and modify the /includes/soy/login.soy file. The file contains a mixture of HTML and Soy template syntax. See Google Closure docs for syntax details. Make sure to jar the file back when you’re done.
  5. Start Confluence and test your changes on a staging environment before applying them to a live site.
Last modified on Feb 3, 2025

Was this helpful?

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