Cloud
Data Center 9.2
Versions

Customizing the Login Page

Changing the Look and Feel of Confluence

On this page

Related content

  • No related content found

Still need help?

The Atlassian Community is here for you.

Ask the community

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.

Related pages:

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

Related content

  • No related content found
Powered by Confluence and Scroll Viewport.