Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
You can use information banners to quickly and effectively communicate with your Azure DevOps users. Alert users to upcoming changes or events without sending mass emails.
Specify one of three types of banners: error, information, or warning. Only the last added or updated banner is displayed at a time. Banners remain in effect until their expiration date.
The following image shows an information message. Users can close the message by selecting the
icon.
We limit banners to 30 words, prioritized by level. So, if you post both a warning message and an information message, the information message only shows after the user closes the warning message or you delete it.
Tip
You can use AI to help with this task later in this article, or see Enable AI assistance with Azure DevOps MCP Server to get started.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Member of the Project Collection Administrators group. |
| Extensions | - Banner Settings. For more information, see Install extensions. - Azure DevOps CLI. - Sign into Azure DevOps using the az login command.- For the examples in this article, set the default organization using az devops configure --defaults organization=<your-organization-URL>. |
| Category | Requirements |
|---|---|
| Permissions | Member of the Project Collection Administrators group. |
| Extensions | Banner Settings. For more information, see Install extensions. |
Manage banners using the Banner Settings extension
The Banner Settings extension provides a settings pane under Organization settings to add and manage sitewide banners. The extension supports the following features:
The Banner Settings extension provides a settings pane under Collection settings to add and manage sitewide banners. The extension supports the following features:
- Show banners on any page in Azure DevOps
- Choose between three levels of messages: Information, Warning, and Error
- Choose an expiration date for a message
- Include hyperlinks in banners using markdown syntax
Open Organization settings
To add or delete a banner, open Organization settings, scroll down to the Extensions section, and choose Banner.
Organization settings configure resources for all projects respectively for the entire organization. For an overview of all organization settings, see Project Collection Administrator role and managing collections of projects.
Choose the
Azure DevOps logo to open Projects, and then choose Organization settings.
Open Admin settings
To add or delete a banner, open Admin settings, scroll down to the Extensions section, and choose Banner.
Admin settings configure resources for all projects in a project collection. For an overview of all collection settings, see Project collection administrator role and managing collections of projects.
Choose the
Azure DevOps logo to open Collections, and then choose Admin settings.
Add and manage banners
If no banners are defined, select Create a new banner. Otherwise, select Edit more for the banner and go to step 3.
Enter the banner text into the text box. Select Edit more to change the message level and set the expiration date.
Save your changes.
(Optional) Delete all banners or select the trash can icon to delete a specific banner.
Use AI to manage information banners
Tip
You can use AI to help with this task later in this article, or see Enable AI assistance with Azure DevOps MCP Server to get started.
If you use GitHub Copilot, the Azure DevOps MCP Server can help you create, update, and manage organization-wide information banners through natural language prompts.
Example prompts for banner management
| Task | Example prompt |
|---|---|
| Announce a maintenance window | Create a warning banner in my Azure DevOps organization that says 'Scheduled maintenance this Saturday 2am-6am UTC — expect intermittent service disruptions' and set it to expire after the maintenance window |
| Rotate banners for sprint milestones | I want to display a different information banner at the start of each sprint with the sprint goals. Show me how to automate this with the Azure DevOps CLI so I can script it into our sprint kickoff process |
| Audit and clean up stale banners | List all active banners in my organization using the CLI, show their expiration dates, and remove any that are past their expiration or no longer relevant |
| Communicate a policy change | Post an error-level banner across our Azure DevOps organization announcing that all repos now require branch policies for main branches, effective next Monday, with a link to our wiki page explaining the new policy |
| Create banners for multiple collections | I manage three Azure DevOps Server collections. Generate CLI commands to post the same maintenance notification banner to all three collections simultaneously |
| Set up a welcome banner for new users | Create a persistent information banner that welcomes users to our Azure DevOps organization with a link to our onboarding wiki. Make sure it stays visible until I manually remove it |
Tip
For the best results, use these prompts in agent mode with the Azure DevOps MCP Server connected. Customize the prompts with your specific organization name, banner message, or schedule.