This version of GitHub Enterprise was discontinued on 2021-09-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

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
  • Announcement banners, which appear at the top of every page

Note: If you are using SAML for authentication, the sign in page is presented by your identity provider and is not customizable via GitHub Enterprise Server.

You can use Markdown to format your message. For more information, see "About writing and formatting on GitHub."

Creating a custom sign in 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. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  3. Under Settings, click Messages. Messages tab in the enterprise settings sidebar

  4. Under "Sign in page", click Add message or Edit message. Edit message button

  5. Under Sign in message, type the message you'd like users to see. Sign in message

  6. To see the rendered message, click Preview. Preview button

  7. Review the rendered message. Sign in message rendered

  8. At the bottom of the page, click Save changes. Save changes

Creating a custom sign out 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. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  3. Under Settings, click Messages. Messages tab in the enterprise settings sidebar

  4. Under "Sign out page", click Add message or Edit message. Add message button

  5. Under Sign out message, type the message you'd like users to see. Sign two_factor_auth_header message

  6. To see the rendered message, click Preview. Preview button

  7. Review the rendered message. Sign out message rendered

  8. At the bottom of the page, click Save changes. Save changes

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. For more information, see "Command-line utilities."

  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. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  3. Under Settings, click Messages. Messages tab in the enterprise settings sidebar

  4. Under "Announcement", click Add announcement. Add announcement button

  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. Click Save changes. Save changes button