Customizing user messages for your enterprise

You can create custom messages that users will see on your GitHub Enterprise Server instance.

About user messages

There are several types of user messages.

  • Messages that appear on the sign in or sign out page
  • Mandatory messages, which appear once in a pop-up window that must be dismissed
  • Announcement banners, which appear at the top of every page

Hinweis: Wenn Sie SAML zur Authentifizierung verwenden, wird die Anmeldeseite von Ihrem Identity Provider bereitgestellt und kann nicht über GitHub Enterprise Server angepasst werden.

Mittels Markdown können Sie Ihre Meldung formatieren. Weitere Informationen finden Sie unter „Informationen zum Schreiben und Formatieren bei GitHub“.

Benutzerdefinierte Meldung für Anmeldung erstellen

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings. "Enterprise settings" in drop-down menu for profile photo on GitHub Enterprise Server

  2. Klicke in der Seitenleiste des Enterprise-Kontos auf Settings (Einstellungen). Registerkarte „Settings“ (Einstellungen) in der Seitenleiste des Enterprise-Kontos

  3. Klicken Sie unter „Settings“ (Einstellungen) auf Messages (Nachrichten). Registerkarte „Messages“ (Nachrichten) auf der Seitenleiste mit den Einstellungen des Enterprise-Kontos

  4. To the right of "Sign in page", click Add message or Edit message. Add message button

  5. Geben Sie unter Sign in message (Meldung für Anmeldung) die Meldung an, die Benutzern angezeigt werden soll. Sign in message

  6. Optionally, to preview your message, click Preview. Preview message button

  7. Klicke auf Save changes (Änderungen speichern). Schaltfläche „Edit message“ (Meldung bearbeiten)

Benutzerdefinierte Meldung für Abmeldung erstellen

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings. "Enterprise settings" in drop-down menu for profile photo on GitHub Enterprise Server

  2. Klicke in der Seitenleiste des Enterprise-Kontos auf Settings (Einstellungen). Registerkarte „Settings“ (Einstellungen) in der Seitenleiste des Enterprise-Kontos

  3. Klicken Sie unter „Settings“ (Einstellungen) auf Messages (Nachrichten). Registerkarte „Messages“ (Nachrichten) auf der Seitenleiste mit den Einstellungen des Enterprise-Kontos

  4. To the right of "Sign out page", click Add message or Edit message. Schaltfläche „Add message“ (Meldung hinzufügen)

  5. Geben Sie unter Sign out message (Meldung für Abmeldung) die Meldung an, die Benutzern angezeigt werden soll. Sign two_factor_auth_header message

  6. Optionally, to preview your message, click Preview. Preview message button

  7. Klicke auf Save changes (Änderungen speichern). Schaltfläche „Edit message“ (Meldung bearbeiten)

Creating a mandatory message

You can create a mandatory message that GitHub Enterprise Server will show to all users the first time they sign in after you save the message. The message appears in a pop-up window that the user must dismiss before the user can use your GitHub Enterprise Server instance.

Mandatory messages have a variety of uses.

  • Providing onboarding information for new employees
  • Telling users how to get help with your GitHub Enterprise Server instance
  • Ensuring that all users read your terms of service for using your GitHub Enterprise Server instance

If you include Markdown checkboxes in the message, all checkboxes must be selected before the user can dismiss the message. For example, if you include your terms of service in the mandatory message, you can require that each user selects a checkbox to confirm the user has read the terms.

Each time a user sees a mandatory message, an audit log event is created. The event includes the version of the message that the user saw. For more information see "Audited actions."

Note: If you change the mandatory message for your GitHub Enterprise Server instance, users who have already acknowledged the message will not see the new message.

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings. "Enterprise settings" in drop-down menu for profile photo on GitHub Enterprise Server

  2. Klicke in der Seitenleiste des Enterprise-Kontos auf Settings (Einstellungen). Registerkarte „Settings“ (Einstellungen) in der Seitenleiste des Enterprise-Kontos

  3. Klicken Sie unter „Settings“ (Einstellungen) auf Messages (Nachrichten). Registerkarte „Messages“ (Nachrichten) auf der Seitenleiste mit den Einstellungen des Enterprise-Kontos

  4. To the right of "Mandatory message", click Add message. Add mandatory message button

  5. Under "Mandatory message", in the text box, type your message. Mandatory message text box

  6. Optionally, to preview your message, click Preview. Preview message button

  7. Klicke auf Save changes (Änderungen speichern). Schaltfläche „Edit message“ (Meldung bearbeiten)

Creating a global announcement banner

You can set a global announcement banner to be displayed to all users at the top of every page.

You can also set an announcement banner in the administrative shell using a command line utility or using the API. For more information, see "Command-line utilities" and "GitHub Enterprise administration."

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings. "Enterprise settings" in drop-down menu for profile photo on GitHub Enterprise Server

  2. Klicke in der Seitenleiste des Enterprise-Kontos auf Settings (Einstellungen). Registerkarte „Settings“ (Einstellungen) in der Seitenleiste des Enterprise-Kontos

  3. Klicken Sie unter „Settings“ (Einstellungen) auf Messages (Nachrichten). Registerkarte „Messages“ (Nachrichten) auf der Seitenleiste mit den Einstellungen des Enterprise-Kontos

  4. To the right of "Announcement", click Add announcement. Schaltfläche „Add message“ (Meldung hinzufügen)

  5. Under "Announcement", in the text field, type the announcement you want displayed in a banner. Text field to enter announcement

  6. Optionally, under "Expires on", select the calendar drop-down menu and click an expiration date. Calendar drop-down menu to choose expiration date

  7. Optionally, to preview your message, click Preview. Preview message button

  8. Klicke auf Save changes (Änderungen speichern). Schaltfläche „Edit message“ (Meldung bearbeiten)

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Oder, learn how to contribute.