- 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
/helppages
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_redirectremoved 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
eeand the documentation path to the URL. - Appends
.htmlto the URL, and removes.mdif 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.