Fix Teams Template Creates the Wrong Channels in a Multi-Geo Tenant
🔍 WiseChecker

Fix Teams Template Creates the Wrong Channels in a Multi-Geo Tenant

When you apply a Teams template in a multi-geo tenant, the new team may end up with channels that do not match the template. This usually happens because the template’s channel names and settings are not fully applied during provisioning. The root cause is often a delay in the template synchronization or a mismatch between the template’s locale and the user’s preferred language. This article explains why this occurs and provides a step-by-step fix to ensure your channels match the template exactly.

Key Takeaways: Correcting Teams Template Channel Mismatches in Multi-Geo Deployments

  • Teams admin center > Teams > Team templates: Review and edit the template’s channel list to confirm the exact channel names you want.
  • Set-CsTeamTemplate cmdlet in PowerShell: Forces a re-sync of the template to all geo locations, resolving stale channel data.
  • Teams admin center > Teams > Manage teams > Channels: Manually add or remove channels after creation when the template fails to apply.

ADVERTISEMENT

Why Teams Templates Produce Wrong Channels in a Multi-Geo Tenant

In a multi-geo tenant, your organization’s data is distributed across different geographic locations. Teams templates are stored in the central location where the template is created, but when a user in another geo applies the template, the provisioning process may not replicate the template’s channel configuration correctly. This happens because the template definition is cached at the user’s geo site, and the cache can become outdated or incomplete.

Another common cause is locale mismatch. If the template was created with channel names in English, but the user applies it with a different language setting, Teams may attempt to translate the channel names, leading to unexpected results. Additionally, if the template has been edited after it was initially published, the changes might not propagate immediately to all geo locations, so users still see the old version.

How Template Provisioning Works Across Geos

When a user creates a team from a template, the Teams service sends a request to the user’s preferred data location. The service then pulls the template definition from the central store and applies it. If the central store is not in sync with the geo site, the channels may be created with default names or missing entirely. This issue is more likely when the template was recently modified or when the tenant has a large number of geo locations.

Steps to Fix Wrong Channels Created by a Teams Template

Follow these steps to correct the channel mismatch and ensure future teams are created correctly.

  1. Verify the Template’s Channel List in Teams Admin Center
    Sign in to the Teams admin center at admin.teams.microsoft.com. Go to Teams > Team templates. Find your template and click its name to open the details. Under Channels, confirm the exact channel names and their order. Note any discrepancies from what you expected. This step confirms whether the template itself is correct or if the issue is in the application process.
  2. Force a Template Re-sync Using PowerShell
    Open Windows PowerShell and connect to Teams using the following command: Connect-MicrosoftTeams. Then run Set-CsTeamTemplate -Identity "YourTemplateName" -Force. This command forces the template to re-sync across all geo locations. Wait at least 30 minutes for the sync to complete before testing again.
  3. Create a Test Team from the Template
    In Teams, click Teams > Join or create a team > Create team. Choose From a template and select your template. Create the team and check the channels. If the channels now match the template, the issue is resolved. If not, proceed to the next step.
  4. Manually Correct Channels on the Affected Team
    If the test team still has wrong channels, go to the team you created. Click the ellipsis (…) next to the team name and select Manage team. Under the Channels tab, you can add or remove channels to match the template. This is a manual workaround that ensures the team is correct even if the template application fails.
  5. Check User Language Settings
    If channel names appear in a different language, the user’s language preference may be overriding the template. Ask the user to go to Settings > Language in Teams and set it to the same language as the template. Then create a new team from the template to see if the channels appear correctly.

ADVERTISEMENT

If Teams Still Creates Wrong Channels After the Main Fix

Teams Shows Default Channel Names Instead of Template Names

If the team is created with channels like “General” and “Announcements” but your template specified custom names, the template may not have been published correctly. Go to the Teams admin center and check if the template has a status of Published. If it is in draft mode, it will not be available to users. Publish the template and wait for the sync to complete.

New Team Missing Channels That Were in the Template

Sometimes the template includes channels that are not created because of permissions. Ensure that the template’s channel settings do not include private channels that the user is not allowed to create. In the template settings, check if any channels are marked as Private. If so, the user must have the appropriate permission to create private channels. Grant the permission in the Teams admin center under Users > User settings.

Template Edits Do Not Apply to New Teams

If you edited the template but new teams still show the old channel structure, the template cache in the geo location may be stale. Use the PowerShell command from step 2 again, but this time also run Get-CsTeamTemplate -Identity "YourTemplateName" | Refresh-CsTeamTemplate. This forces an immediate refresh. Then wait 15 minutes and test again.

Teams Template Channel Behavior: Desktop vs Web App

Item Teams Desktop App Teams on the Web
Template availability Full template list with all channels May show a reduced list if the web session has locale mismatches
Channel creation speed Faster due to local caching Slower as it depends on server-side provisioning
Language override Uses the app language setting Uses the browser language setting, which may differ
Manual channel editing Available under Manage team Same as desktop, but may have UI delays

After following these steps, you should be able to create teams with the correct channels from your template. If the issue persists, contact Microsoft Support with the template ID and the geo location of the affected user. For ongoing management, consider using the Set-CsTeamTemplate cmdlet in a scheduled script to keep templates in sync across all geos.

ADVERTISEMENT