About user messages
There are several types of user messages.
- Messages that appear on the 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
Creating a custom sign out message
-
In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.
-
In the enterprise account sidebar, click Settings.
-
Under Settings, click Announcement.
-
To the right of "Sign out page", click Add message or Edit message.
-
Under Sign out message, type the message you'd like users to see.
-
Optionally, to preview your message, click Preview.
-
Click Save changes.
Creating a mandatory message
You can create a mandatory message that GitHub AE 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 using your enterprise.
Mandatory messages have a variety of uses.
- Providing onboarding information for new employees
- Telling users how to get help with your enterprise
- Ensuring that all users read your terms of service for using your enterprise
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 "Audit log events for your enterprise."
Note: If you change the mandatory message for your enterprise, users who have already acknowledged the message will not see the new message.
-
In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.
-
In the enterprise account sidebar, click Settings.
-
Under Settings, click Announcement.
-
To the right of "Mandatory message", click Add mandatory message.
-
Under "Mandatory message", in the text box, type your message.
-
Optionally, to preview your message, click Preview.
-
Click 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 using the API. For more information, see "GitHub Enterprise administration."
-
In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.
-
In the enterprise account sidebar, click Settings.
-
Under Settings, click Announcement.
-
To the right of "Announcement", click Add announcement.
-
Under "Announcement", in the text field, type the announcement you want displayed in a banner.
-
Optionally, under "Expires on", select the calendar drop-down menu and click an expiration date.
Note: Announcements must either have an expiration date, be user dismissible, or both.
-
Optionally, to allow each user to dismiss the announcement, select User dismissible.
-
Optionally, to preview your message, click Preview.
-
Click Save changes.