doc/customization/branded_login_page.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

---
type: howto
---

# Changing the logo and description on the login page

You can customize the login page of your GitLab server to show the logo and
description of your organization.

By default, the page shows the GitLab logo and description:

![default_login_page](branded_login_page/default_login_page.png)

To customize the login page:

1. Navigate to the **Admin** area and go to the **Appearance** page.
1. Fill in your desired Title and Description. You can also choose an image file
   of the logo for your organization.

   ![appearance](branded_login_page/appearance.png)

1. Save your changes.

Your GitLab login page will display the details you provided:

![company_login_page](branded_login_page/custom_sign_in.png)

<!-- ## Troubleshooting

Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.

Each scenario can be a third-level heading, e.g. `### Getting error message X`.
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->