Login
In this article you can learn the various ways of customizing the Umbraco backoffice login screen and form.
To access the backoffice, you will need to login. You can do this by adding /umbraco
at the end of your website URL, e.g. http://mywebsite.com/umbraco.
You will be presented with a login form similar to this:
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F65787334-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8h0xdoteqcFVV1pGZgk0%252Fuploads%252Fgit-blob-33a9ca746bea0e5a0d8768651bca691a2e5d953a%252Flogin-backoffice-login.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=1a8b72fa&sv=1)
The login screen contains a Greeting, Email, Password field and optionally a Forgotten password link
Below, you will find instructions on how to customize the login screen.
Greeting
The login screen features a greeting which you can personalize by overriding the existing language translation keys. To do this, create a 'user' translation file for the default language of your Umbraco site, (usually en-US) to override the greetings. For en-US, you'd create a file called: en_us.user.xml
in the directory ~/config/lang/
. Then take the relevant keys (listed below) and add them to your ~/config/lang/en_us.user.xml
file, and update the greetings as necessary. Note: the config
directory needs to be in the root of your project (not the wwwroot
).
Before the changes takes place you will need to restart the site.
You can customize other text on the login screen as well. First, grab the default values and keys from the en.xml in the Umbraco CMS Github repository. Thereafter copy the ones you want to translate into ~/config/lang/en_us.user.xml
file.
Password reset
The Forgotten password? link allows your backoffice users to reset their password. To use this feature, you will need to add the following key to the Umbraco.Cms.Security
section in the appsettings.json
file:
Set it to true
to enable the password reset feature, and false
to disable the feature.
You will also need to configure an Simple Mail Transfer Protocol (SMTP) server in your appsettings.json
file. When you get a successful result on the SMTP configuration when running a health check in the backoffice, you are good to go!
An example:
Custom background image and logo
It is possible to customize the background image and the logo for the backoffice login screen by adding the "Content"
section in the appsettings.json
file:
The LoginBackgroundImage
and LoginLogoImage
are referenced from the /wwwroot/umbraco/
folder.
To affect the styling of the images add a folder to the /App_Plugins
folder containing a CSS
folder, containing a CSS file, and a package.manifest file. An example structure might be:
An example stylesheet might be:
An example package.manifest might be:
Last updated