Edit

Share via


Add and manage information banners in Azure DevOps

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.

Information banner

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.

    Screenshot of opening 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.

    Screenshot of opening Admin settings.

Add and manage banners

  1. If no banners are defined, select Create a new banner. Otherwise, select Edit more for the banner and go to step 3.

    Screenshot showing Create first banner, on-premises in Azure Devops.

    Screenshot showing Create first banner, on-premises.

  2. Enter the banner text into the text box. Select Edit more to change the message level and set the expiration date.

    Screenshot showing Add test banner message.

  3. Save your changes.

  4. (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.