Deploy frontline dynamic teams at scale

Overview

Note

Mapping frontline attributes to the department and job titles in your organization to enable targeted communications is currently in public preview.

Frontline teams are a collection of people, content, and tools within an organization for different frontline worker locations. Membership of frontline dynamic teams is determined and managed by a set of Microsoft Entra attributes. Learn more about Microsoft Entra attributes.

In the setup process, you define the following information with Microsoft Entra attributes:

  • Who your frontline workers are
  • What locations they work at
  • (Preview) Department and job titles of your frontline workers (optional)

You also determine team structure and team owners.

Then, you can choose which locations you want to create dynamic frontline teams for.

Team membership is automatically managed over time through the power of dynamic teams. As frontline workers are onboarded, offboarded, or change locations, their membership in these teams are updated accordingly.

Check out this Microsoft Mechanics video for an overview of how to set up and deploy your frontline dynamic teams.

Note

If you would like to provide feedback and improve this feature, please fill out this form.

Prerequisites

Important

The admin running the deployment process must be a Global admin.

When evaluating the right solution for your organization, we recommend you do the following:

  1. Plan your frontline deployment.
  2. Test the deploy tools—dynamic team creation (the process described in this article) or static team creation (using the PowerShell solution). Keep in mind that static teams aren't managed automatically.
  3. Deploy to a pilot location.
  4. Deploy to a broader set of locations using a phased approach.

Set up your frontline dynamic teams

  1. In the left navigation of the Teams admin center, choose Frontline deployment > Manage frontline teams.

  2. In the table, choose Set up.

    Screenshot of the Manage frontline teams page, showing the Set up button.

  3. Review the setup and prerequisites information.

  4. On the Identify your frontline workers page, select the Microsoft Entra attribute that defines your frontline workers. You can only choose one Microsoft Entra attribute, but you can define multiple values by separating them with commas.

    Screenshot showing where to enter your Microsoft Entra attribute and values to identify your frontline workforce.

  5. On the Location page, select the Microsoft Entra attribute that defines the location your frontline employees work in. You can only choose one location attribute.

    Screenshot showing where to enter your Microsoft Entra attribute that identifies the location where your frontline employees work.

  6. On the Team settings page, define a naming pattern for your teams by choosing a prefix. The prefix is applied using the "prefix-location" format to all your teams.

    Screenshot of team settings options showing the prefix, team template, and team owner fields.

  7. Optionally, choose a team template. The team template you choose defines the channel structure for all your frontline teams. Learn more about team templates.

    Note

    Currently, only team templates that are set to the English (United States) locale are supported. Keep in mind that the locale doesn't affect translation of the template or data residency. The locale setting is used only to distinguish between templates that have the same name that are created in different languages.

  8. Enter the object ID of the user account who you want as the team owner. This account will be the owner of all frontline teams. We recommend you choose a shared account rather than an individual person.

    1. To get a user's object ID, go to the Azure portal.
    2. Select Microsoft Entra ID.
    3. Select Users, and then choose your user.
    4. Copy the user's object ID.
  9. (Preview) On the Map frontline attributes page, select the Microsoft Entra attributes that most accurately reflect the departments and job titles in your organization. You can set the Department attribute, Job title attribute, or both.

    Note

    This step is optional. If you choose not to map frontline attributes, leave the values as None. You can always come back and map them later on the Dynamic teams settings page.

    Screenshot showing where to map your Microsoft Entra attributes for Job title and Department.

    These attributes map departments and job titles in your organization, which allows you to deliver targeted communications features, such as automatic tags, to your frontline. Your frontline workers can quickly and easily reach the right group of people through tags that are automatically created based on the attribute mappings. Learn more about attribute mapping and targeted communications.

  10. Review your settings, and then choose Finish setup.

    Note

    Setup can take several hours to run. Refresh the Manage frontline teams page to get the latest status.

    Screenshot of the Manage frontline teams page with a banner showing that setup is in progress.

Deploy your frontline dynamic teams

  1. After setup is completed, go to the Manage frontline teams page, and then select the Deploy button.

    Screenshot of the Manage frontline teams page, showing the Deploy button.

  2. From here, you can review your settings and view the list of locations that don't yet have a frontline dynamic team created.

  3. In the table, select the locations that you want to create teams for.

    Screenshot of the table of locations.

  4. Select Deploy. This process can take several hours depending on how many teams you're creating.

    After deployment is completed, you'll see the number of deployed frontline teams in the Frontline teams card. You can also download a CSV file with a list of those teams.

    Screenshot of where you can get the CSV file on the Manage frontline teams page.

    If an error occurred during the deployment process, you can download the error CSV file on the Last deployment health card. Use the information in it to help resolve the errors, and then rerun the deployment experience

  5. You can repeat this process for any frontline locations that don't have a team.

Managing your frontline dynamic teams

You can manage your teams when changes happen in your organization.

Create new teams for newly opened locations

  1. In the left navigation of the Teams admin center, choose Frontline deployment > Manage frontline teams.

  2. In the table, choose Deploy.

  3. Select the Refresh location button, and then proceed when prompted by the dialog box. This process can take several hours depending on your number of new locations.

    Screenshot of the Refresh location button.

  4. After the refresh is completed, your setup status shows as Complete. You can proceed to deploy your new teams. Deployment can take several hours depending on how many new teams you're deploying.

Edit your frontline team settings

  1. In the left navigation of the Teams admin center, choose Frontline deployment > Manage frontline teams.

  2. In the Deployment settings column, choose Deploy teams with dynamic membership.

  3. On the Dynamic teams settings page, edit your settings, and then select Apply. Your settings might take several hours to update.

    Screenshot of the Dynamic teams settings page, showing options to edit frontline team settings

    See the following table for the effects of updating your settings.

    Setting Effect on existing frontline teams Effect on new frontline teams
    Define your frontline worker attribute. All existing frontline teams will be members that have the new Microsoft Entra attribute defined. All new frontline teams members will have the new Microsoft Entra attribute defined.
    Choose the values applicable to your frontline Microsoft Entra attribute. All existing frontline team members will reflect your updated values. All new teams will be populated with members who have the updated Microsoft Entra attributes that you defined.
    (Preview) Map your frontline attributes for department and job title. All existing frontline team members will reflect the Microsoft Entra attribute you defined for department and job title. All new frontline team members will use the Microsoft Entra attribute you defined for department and job title.
    Define your frontline locations. Existing teams will continue to persist. If a team is no longer tied to a location, there will be no users in that team, and users are put in their respective location teams. You can create new frontline teams based on the locations defined by your new Microsoft Entra attribute.
    Set your team name prefix. All existing team names will be updated to reflect the prefix and location name if that was changed. All new teams will have the updated naming convention.
    Select your team template. No updates to the team structure will occur. All new teams will use the updated team template.
    Select your team owner. The team owner will be updated for all existing teams. All new teams will have the updated team owner.

Get analytics on frontline teams usage

The Teams usage report in Teams admin center gives you an overview of usage activity in Teams. You can use the report to view usage details for your frontline teams, including active users, active channels, total organized meetings, last activity date, and other information.

  1. In the left navigation of the Teams admin center, choose Analytics & reports > Usage reports.

  2. On the View reports tab, under Report, select Teams usage.

  3. Under Date range, select a date range of 7 days, 30 days, 90 days, or 180 days. Then, choose Run report.

  4. In the upper-right corner, select Export to Excel > Export table as CSV.

  5. Filter the spreadsheet based on your frontline team IDs.

    Note

    To get a list of your frontline team IDs, in the Teams admin center, go to Frontline deployment > Manage frontline teams, and then in the Frontline teams section, select Download CSV.

Frequently asked questions

Why are channels missing when I create my teams?

It can take time for channels to propagate in Teams. The General channel is created first and the remaining channels are added over time. All channels should be available within 24 hours of team creation.

How do I delete a frontline team?

You can delete a team by using the Teams client, Teams admin center, PowerShell, or Graph.

Keep in mind that it can take up to 24 hours for a team and the Microsoft 365 group associated with the team to be fully deleted.

If you need to redeploy a frontline location team that was deleted, follow these steps:

  1. Refresh locations.
  2. After the refresh is completed, choose the location you want to deploy.
  3. Select Deploy.