- Add a help message to the Help page
- Add a help message to the sign-in page
- Hide marketing-related entries from the Help page
- Set a custom Support page URL
-
Redirect
/help
pages
Customize the Help and sign-in page messages
In large organizations, it is useful to have information about who to contact or where
to go for help. You can customize and display this information on the GitLab /help
page and on
the GitLab sign-in page.
Add a help message to the Help page
You can add a help message, which is shown at the top of the GitLab /help
page (for example,
https://gitlab.com/help):
- On the top bar, select Main menu > Admin.
- On the left sidebar, select Settings > Preferences.
- Expand Sign-in and Help page.
- In Additional text to show on the Help page, enter the information you want to display on
/help
. - Select Save changes.
You can now see the message on /help
.
/help
is visible to unauthenticated users. However, if the
Public visibility level
is restricted, /help
is visible only to authenticated users.Add a help message to the sign-in page
You can add a help message, which is shown on the GitLab sign-in page. The message appears on the sign-in page:
- On the top bar, select Main menu > Admin.
- On the left sidebar, select Settings > Preferences.
- Expand Sign-in and Help page.
- In Additional text to show on the sign-in page, enter the information you want to display on the sign-in page.
- Select Save changes.
You can now see the message on the sign-in page.
Hide marketing-related entries from the Help page
GitLab marketing-related entries are occasionally shown on the Help page. To hide these entries:
- On the top bar, select Main menu > Admin.
- On the left sidebar, select Settings > Preferences.
- Expand Sign-in and Help page.
- Select the Hide marketing-related entries from the Help page checkbox.
- Select Save changes.
Set a custom Support page URL
You can specify a custom URL to which users are directed when they:
- Select Support from the Help dropdown list.
- Select See our website for help on the Help page.
- On the top bar, select Main menu > Admin.
- On the left sidebar, select Settings > Preferences.
- Expand Sign-in and Help page.
- In the Support page URL field, enter the URL.
- Select Save changes.
Redirect /help
pages
- Introduced in GitLab 13.5.
-
Feature flag
help_page_documentation_redirect
removed in GitLab 14.4. - Generally available in GitLab 14.4.
The /help
URL of a GitLab instance displays a basic version of the documentation sourced from the
doc
directory of GitLab. /help
links
are often used for contextual help.
You can redirect these /help
links to either:
- The more navigable and searchable version published at
docs.gitlab.com
. - A destination that meets necessary requirements.
- On the top bar, select Main menu > Admin.
- On the left sidebar, select Settings > Preferences.
- Expand Sign-in and Help page.
- In the Documentation pages URL field, enter the URL.
- Select Save changes.
Destination requirements
When redirecting /help
, GitLab:
- Redirects requests to the specified URL.
- Appends
ee
and the documentation path to the URL. - Appends
.html
to the URL, and removes.md
if necessary.
For example, if the URL is set to https://docs.gitlab.com
, requests for
/help/user/admin_area/settings/help_page.md
redirect to:
https://docs.gitlab.com/ee/user/admin_area/settings/help_page.html
.